IDirect3DVolume9::GetPrivateData メソッド
IDirect3DVolume9::GetPrivateData メソッド
ボリュームに関連付けられたプライベート データを提供されたバッファにコピーする。
構文
HRESULT GetPrivateData(
REFGUID refguid,
void *pData,
DWORD *pSizeOfData
);
パラメータ
- refguid
[in] 取得するプライベート データを識別するグローバル一意識別子への参照 (C++) またはアドレス (C)。 - pData
[in, out] 呼び出しが成功した場合に、要求したプライベート データを格納する割り当て済みバッファへのポインタ。このメソッドを呼び出すアプリケーションは、このバッファの割り当てと解放に責任を負う。このパラメータが NULL の場合、このメソッドは pSizeOfData にバッファ サイズを返す。 - pSizeOfData
[in, out] pData のバッファ サイズ (バイト単位) へのポインタ。この値が実際のプライベート データのサイズよりも小さい (0 など) 場合、メソッドはこのパラメータを要求されるバッファ サイズに設定し、D3DERR_MOREDATA を返す。
戻り値
成功した場合は、D3D_OK を返す。
失敗した場合は、次のいずれかの値を返す。
D3DERR_INVALIDCALL | メソッドの呼び出しが無効である。たとえば、メソッドのパラメータに無効な値が設定されている場合などである。 |
D3DERR_MOREDATA | 指定されたバッファ サイズに保持できる以上のデータが存在する。 |
D3DERR_NOTFOUND | 要求された項目が見つからなかった。 |
参照
IDirect3DVolume9::FreePrivateData、IDirect3DVolume9::SetPrivateData