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

  • [アーティクル]

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

構文

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 として宣言する必要がある 1 つの頂点ストリームのみをサポートします。

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

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

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

要件

要件 値
対象プラットフォーム Windows
ヘッダー d3d9.h (D3D9.h を含む)
Library D3D9.lib

こちらもご覧ください

IDirect3DDevice9

IDirect3DDevice9::DrawPrimitive

頂点バッファーとインデックス バッファーからのレンダリング (Direct3D 9)