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 へのポインターである場合、またはその派生クラスの 1 つ (D3DSPD_IUNKNOWN フラグを使用して SetPrivateData によって以前に設定された) は、プライベート データが返される前に、そのインターフェイスの参照カウントがインクリメントされます。

要求事項

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	d3d9helper.h (D3D9.h を含む)
図書館	D3D9.lib

こちらも参照ください

IDirect3DVolume9

IDirect3DVolume9::FreePrivateData

IDirect3DVolume9::SetPrivateData