Microsoft DirectX 8.0 (Visual Basic)

Direct3DVolume8.SetPrivateData

Microsoft® Direct3D® ではなく、アプリケーションでの使用が意図されているボリュームとデータを関連付ける。

object.SetPrivateData( _ 
    RefGuid As DXGUID, _ 
    Data As Any, _ 
    SizeOfData As Long, _ 
    Flags As Long)

指定項目

object
Direct3DVolume8 オブジェクトを表すオブジェクト式。
RefGuid
設定するプライベート データを識別するグローバル ユニーク識別子 (GUID)。DXGUID 型で指定する。
Data
サーフェスと関連付けるデータが格納されているバッファ。
SizeOfData
Data のバッファ サイズ (バイト単位)。
Flags
渡されるデータ型を記述する値、またはリソースが変更された場合にデータを無効にする必要があることをアプリケーションに示す値。このパラメータには、CONST_D3DSPDFLAGS 列挙で定義されている値または 0 を指定できる。フラグを指定しない場合、Direct3D はメモリを割り当ててバッファ内のデータを保持し、新しいバッファにデータをコピーする。Direct3D によって割り当てられるバッファは、適宜自動的に解放される。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
E_OUTOFMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

Direct3D は Data でメモリを管理しない。このバッファを動的に割り当てた場合は、呼び出し側の責任でメモリを解放する。

データは値で渡され、複数のデータ セットを単一のボリュームと関連付けることができる。

参照

Direct3DVolume8.FreePrivateDataDirect3DVolume8.GetPrivateData