Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::SetStreamSource

頂点バッファをデバイスのデータ ストリームにバインドする。

HRESULT SetStreamSource(
  UINT StreamNumber,
  IDirect3DVertexBuffer8* pStreamData,
  UINT Stride
);

パラメータ

StreamNumber
[in] 0 からストリームの最大数 - 1 までの範囲のデータ ストリームを指定する。
pStreamData
[in] IDirect3DVertexBuffer8 インターフェイスへのポインタ。指定したデータ ストリームにバインドする頂点バッファを示す。
Stride
[in] コンポーネントのストライド (バイト単位)。「注意」を参照すること。

戻り値

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

失敗した場合は、D3DERR_INVALIDCALL を返す。

注意

このメソッドは、割り当てられるストリームの参照カウントをインクリメントする。テクスチャが不要になった場合は、該当するステージのテクスチャを NULL に設定しなければならない。これを行わなかった場合、サーフェスは解放されず、メモリ リークが発生する。

柔軟な頂点フォーマット (FVF) 頂点シェーダを使用する場合、SetStreamSource のストリーム頂点ストライドは、FVF から計算された頂点サイズと一致していなければならない。この宣言を使用する場合、SetStreamSource のストリーム頂点ストライドは、宣言から計算されたストリーム サイズ以上でなければならない。

SetStreamSource メソッドは、頂点バッファをデバイスのデータ ストリームにバインドする。詳細については、「ストリーム ソースの設定」を参照すること。

テクスチャが必要なくなったとき、適切なステージでそのテクスチャを NULL に設定すること。

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DDevice8::DrawIndexedPrimitiveIDirect3DDevice8::DrawIndexedPrimitiveUPIDirect3DDevice8::DrawPrimitiveIDirect3DDevice8::DrawPrimitiveUPIDirect3DDevice8::GetStreamSource