IDirect3DDevice9::DrawPrimitive メソッド

  • [アーティクル]

IDirect3DDevice9::DrawPrimitive メソッド

現在のデータ入力ストリーム セットから、指定されたタイプの非インデックス付きジオメトリ プリミティブのシーケンスをレンダリングする。

構文

HRESULT DrawPrimitive(      
    D3DPRIMITIVETYPE PrimitiveType,
    UINT StartVertex,
    UINT PrimitiveCount
);

パラメータ

  • PrimitiveType
    [in] D3DPRIMITIVETYPE 列挙型のメンバ。レンダリングするプリミティブの種類を記述する。
  • StartVertex
    [in] ロードする最初の頂点のインデックス。StartVertex を先頭に、正しい頂点数が頂点バッファから読み取られる。
  • PrimitiveCount
    [in] レンダリングするプリミティブの数。プリミティブの許容最大数は、D3DCAPS9 構造体の MaxPrimitiveCount メンバをチェックして決定される。PrimitiveCount は、プリミティブ タイプで指定されたプリミティブの数である。ライン リストの場合、各プリミティブは 2 つの頂点を持つ。三角形リストの場合、各プリミティブは 3 つの頂点を持つ。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合の戻り値は次のとおり。

D3DERR_INVALIDCALL メソッドの呼び出しが無効である。たとえば、メソッドのパラメータに無効な値が設定されている場合などである。

注意

一度に 1 つの三角形を指定して IDirect3DDevice9::DrawPrimitive を呼び出すべきではない。

従来の、固定機能を持つアプリケーションを Microsoft® DirectX® 9.0 に移行する際は、Draw 呼び出しを行う前に IDirect3DDevice9::SetFVF への呼び出しを追加する必要がある。

参照

IDirect3DDevice9::DrawIndexedPrimitive、IDirect3DDevice9::SetStreamSource、プリミティブのレンダリング