IDirect3DDevice9::GetStreamSource メソッド (d3d9.h)

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

指定したデータストリームにバインドされた頂点バッファーを取得します。

構文

HRESULT GetStreamSource(
  UINT                   StreamNumber,
  IDirect3DVertexBuffer9 **ppStreamData,
  UINT                   *pOffsetInBytes,
  UINT                   *pStride
);

パラメーター

StreamNumber

型: [in] UINT

0 から最大ストリーム数から 1 を引いた範囲のデータストリームを指定します。

ppStreamData

型: [in, out] IDirect3DVertexBuffer9**

指定したデータストリームにバインドされた返された頂点バッファーを表す IDirect3DVertexBuffer9 インターフェイスへのポインターのアドレス。

pOffsetInBytes

型: [out]UINT*

ストリームの先頭から頂点データの先頭までのオフセットを含むポインター。オフセットはバイト単位で測定されます。「解説」を参照してください。

pStride

型: [out] UINT*

コンポーネントの返されたストライドへのポインター (バイト単位)。「解説」を参照してください。

戻り値

型: HRESULT

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

注釈

ストリームは、コンポーネントデータの均一な配列として定義されます。各コンポーネントは、位置、法線、色などの 1 つのエンティティを表す 1 つ以上の要素で構成されます。

FVF 頂点シェーダーを使用する場合、頂点ストリームのストライドは、FVF から計算された頂点サイズと一致する必要があります。宣言を使用する場合、ストライドは、宣言から計算されたストリームサイズ以上である必要があります。

このメソッドを呼び出すと、 IDirect3DVertexBuffer9 インターフェイスの内部参照カウントが増加します。この IDirect3DVertexBuffer9 インターフェイスの使用が完了したときに IUnknown::Release を呼び出さなかった場合、メモリリークが発生します。