Share via

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