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

  • [アーティクル]

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

構文

HRESULT DrawPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             PrimitiveCount,
  [in] const void       *pVertexStreamZeroData,
  [in] UINT             VertexStreamZeroStride
);

パラメーター

[in] PrimitiveType

型: D3DPRIMITIVETYPE

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

[in] PrimitiveCount

型: UINT

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

[in] pVertexStreamZeroData

型: const void*

頂点データへのユーザー メモリ ポインター。

[in] VertexStreamZeroStride

型: UINT

各頂点のデータのバイト数。 この値は 0 にすることはできません。

戻り値

型: HRESULT

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

解説

このメソッドは、頂点データを頂点バッファーに格納できないアプリケーションで使用することを目的としています。 このメソッドは、1 つの頂点ストリームのみをサポートします。 この呼び出しの効果は、頂点ストリーム 0 に対して指定された頂点データ ポインターとストライドを使用することです。 現在の頂点シェーダーの宣言でストリーム 0 以外の頂点ストリームを参照することは無効です。

IDirect3DDevice9::D rawPrimitiveUP 呼び出しの後、IDirect3DDevice9::GetStreamSource によって参照されるストリーム 0 設定は NULL に設定されます。

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

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

要件

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

関連項目

IDirect3DDevice9

IDirect3DDevice9::DrawIndexedPrimitiveUP

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