Метод IDirect3DVolume9::GetPrivateData (d3d9helper.h)

Копирует частные данные, связанные с томом, в предоставленный буфер.

Синтаксис

HRESULT GetPrivateData(
  [in]      REFGUID refguid,
  [in, out] void    *pData,
  [in, out] DWORD   *pSizeOfData
);

Параметры

[in] refguid

Тип: REFGUID

Ссылка на (C++) или адрес (C) глобально уникальный идентификатор, определяющий извлекаемые частные данные.

[in, out] pData

Тип: void*

Указатель на ранее выделенный буфер для заполнения запрошенных частных данных при успешном вызове. Приложение, вызывающее этот метод, отвечает за выделение и освобождение этого буфера. Если этот параметр имеет значение NULL, этот метод возвращает размер буфера в pSizeOfData.

[in, out] pSizeOfData

Тип: DWORD*

Указатель на размер буфера в pData в байтах. Если это значение меньше фактического размера частных данных, например 0, метод задает этот параметр требуемому размеру буфера, а метод возвращает D3DERR_MOREDATA.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение D3D_OK. Если метод завершается ошибкой, возвращаемое значение может быть одним из следующих: D3DERR_INVALIDCALL, D3DERR_MOREDATA, D3DERR_NOTFOUND.

Замечания

Если возвращенные данные являются указателем на IUnknown или один из его производных классов, который ранее был задан SetPrivateData с флагом D3DSPD_IUNKNOWN , этот интерфейс будет иметь его число ссылок с увеличением до возврата частных данных.

Требования

См. также

IDirect3DVolume9

IDirect3DVolume9::FreePrivateData

IDirect3DVolume9::SetPrivateData