Microsoft DirectX 8.1 (C++)

IDirectXFileData::GetData

Retrieves the data for one of the object's members or the data for all members.

HRESULT GetData(
  LPCSTR szMember,
  DWORD* pcbSize,
  void** ppvData
);

Parameters

szMember
[in] Pointer to the name of the member for which to retrieve data. Specify NULL to retrieve all required members' data.
pcbSize
[out] Pointer to receive the ppvData buffer size, in bytes.
ppvData
[out] Address of a pointer to the buffer to receive the data associated with szMember. If szMember is NULL, ppvData is set to point to a buffer containing all required members' data in a contiguous block of memory.

Return Values

If the method succeeds, the return value is DXFILE_OK.

If the method fails, the return value can be one of the following values.

DXFILEERR_BADARRAYSIZE
DXFILEERR_BADDATAREFERENCE
DXFILEERR_BADVALUE

Remarks

This method retrieves the data for required members of a data object but no data for optional (child) members. Use IDirectXFileData::GetNextObject to retrieve child objects.

Requirements

  Header: Declared in Dxfile.h.
  Import Library: Use D3dxof.lib.

See Also

IDirectXFileData::GetNextObject