Win32 API 日本語リファレンス
ホームGraphics.Direct3D9 › IDirect3DVertexDeclaration9

IDirect3DVertexDeclaration9

COM
IIDdd13c59c-36fa-4098-a8fb-c7ed39dc8546継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IDirect3DVertexDeclaration9 (d3d9.h) インターフェイスは、頂点シェーダー宣言をカプセル化するためにアプリケーションが使用します。

解説(Remarks)

頂点シェーダー宣言は、頂点要素の配列で構成されます。

LPDIRECT3DVERTEXDECLARATION9 型および PDIRECT3DVERTEXDECLARATION9 型は、IDirect3DVertexDeclaration9 インターフェイスへのポインターとして定義されています。

typedef struct IDirect3DVertexDeclaration9 *LPDIRECT3DVERTEXDECLARATION9, *PDIRECT3DVERTEXDECLARATION9;

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetDevice(IDirect3DDevice9** ppDevice)

IDirect3DVertexDeclaration9::GetDevice (d3d9.h) メソッドは、現在のデバイスを取得します。

ppDeviceIDirect3DDevice9**out返される IDirect3DDevice9 インターフェイスへのポインター。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL。

vtbl 4 HRESULT GetDeclaration(D3DVERTEXELEMENT9* pElement, DWORD* pNumElements)

IDirect3DVertexDeclaration9::GetDeclaration (d3d9.h) メソッドは、頂点シェーダー宣言を取得します。

pElementD3DVERTEXELEMENT9*inout頂点シェーダー宣言を構成する頂点要素 (D3DVERTEXELEMENT9 を参照) の配列。アプリケーションは、これに十分な領域を割り当てる必要があります。頂点要素の配列は D3DDECL_END マクロで終わります。
pNumElementsDWORD*inout配列内の要素数。アプリケーションは、これに十分な領域を割り当てる必要があります。

戻り値

型: HRESULT

メソッドが成功した場合、戻り値は D3D_OK です。メソッドが失敗した場合、戻り値は次のいずれかになります: D3DERR_INVALIDCALL。

解説(Remarks)

要素数 pNumElements には、宣言を終了させる D3DDECL_END マクロが含まれます。そのため、要素数は実際の有効な頂点要素の数より 1 つ多くなります。

次に、最大 256 要素の頂点宣言配列を取得する例を示します。

 
D3DVERTEXELEMENT9 decl[MAXD3DDECLLENGTH];
UINT numElements;
HRESULT hr = m_pVertexDeclaration->GetDeclaration( decl, &numElements);

宣言内の要素数を取得するには、pDecl に NULL を指定します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IDirect3DVertexDeclaration9 "{DD13C59C-36FA-4098-A8FB-C7ED39DC8546}"
#usecom global IDirect3DVertexDeclaration9 IID_IDirect3DVertexDeclaration9 "{}"
#comfunc global IDirect3DVertexDeclaration9_GetDevice       3 sptr
#comfunc global IDirect3DVertexDeclaration9_GetDeclaration  4 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。