IDirect3DDevice9::D rawIndexedPrimitiveUP メソッド (d3d9helper.h)

[アーティクル]
03/05/2024

ユーザーメモリポインターによって指定されたデータを使用して、指定されたジオメトリックプリミティブをレンダリングします。

構文

HRESULT DrawIndexedPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             PrimitiveCount,
  [in] const void       *pIndexData,
  [in] D3DFORMAT        IndexDataFormat,
  [in] const void       *pVertexStreamZeroData,
  [in] UINT             VertexStreamZeroStride
);

パラメーター

[in] PrimitiveType

種類: D3DPRIMITIVETYPE

D3DPRIMITIVETYPE列挙型のメンバー。レンダリングするプリミティブの型を記述します。

[in] MinVertexIndex

型: UINT

最小頂点インデックス。これは 0 から始まるインデックスです。

[in] NumVertices

型: UINT

この呼び出し中に使用される頂点の数。最初の頂点は、インデックス MinVertexIndex にあります。

[in] PrimitiveCount

型: UINT

レンダリングするプリミティブの数。許可されるプリミティブの最大数は、 D3DCAPS9 構造体の MaxPrimitiveCount メンバーを確認することによって決定されます (インデックスの数はプリミティブ数とプリミティブ型の関数です)。

[in] pIndexData

型: const void*

インデックスデータへのユーザーメモリポインター。

[in] IndexDataFormat

種類: D3DFORMAT

インデックスデータの形式を記述する、 D3DFORMAT 列挙型のメンバー。有効な設定は次のいずれかです。

[in] pVertexStreamZeroData

型: const void*

頂点データへのユーザーメモリポインター。頂点データはストリーム 0 内にある必要があります。

[in] VertexStreamZeroStride

型: UINT

各頂点のデータのバイト数。この値は 0 でない場合があります。

戻り値

種類: HRESULT

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

注釈

このメソッドは、頂点データを頂点バッファーに格納できないアプリケーションで使用することを目的としています。このメソッドは、ストリーム 0 として宣言する必要がある単一の頂点ストリームのみをサポートします。

IDirect3DDevice9::D rawIndexedPrimitiveUP 呼び出しの後、IDirect3DDevice9::GetStreamSource によって参照されるストリーム 0 設定は NULL に設定されます。また、 IDirect3DDevice9::SetIndices のインデックスバッファー設定は NULL に設定されています。

IDirect3DDevice9::D rawIndexedPrimitiveUP に渡される頂点データは、呼び出し後に保持する必要はありません。 Direct3D は、呼び出しから戻る前に、そのデータへのアクセスを完了します。

レガシアプリケーションを Direct3D 9 に変換する場合は、固定関数パイプラインを使用するために IDirect3DDevice9::SetFVF に呼び出しを追加するか、または IDirect3DDevice9::SetVertexDeclaration を使用して頂点シェーダーを使用してから Draw 呼び出しを行う必要があります。