IDirect3DDevice9::GetStreamSource 方法 (d3d9helper.h)

擷取系結至指定數據流的頂點緩衝區。

語法

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

參數

StreamNumber

類型:[in] UINT

指定數據流,範圍從0到數據流數目上限減一。

ppStreamData

類型:[in, out] IDirect3DVertexBuffer9**

IDirect3DVertexBuffer9 介面指標的位址,表示系結至指定數據流的傳回頂點緩衝區。

OffsetInBytes

類型: [out] UINT*

指標,其中包含從數據流開頭到頂點數據開頭的位移。 位移是以位元組為單位來測量。 請參閱<備註>。

pStride

類型: [out] UINT*

以位元組為單位之元件傳回之步幅的指標。 請參閱<備註>。

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。 如果方法失敗,則傳回值可以D3DERR_INVALIDCALL。

備註

數據流定義為元件數據的統一數位列,其中每個元件都包含一或多個元素,代表單一實體,例如位置、一般、色彩等等。

使用 FVF 頂點著色器時,頂點數據流的步調必須符合從 FVF 計算的頂點大小。 使用宣告時,步幅應大於或等於從宣告計算的數據流大小。

呼叫這個方法會增加 IDirect3DVertexBuffer9 介面上的內部參考計數。 使用這個 IDirect3DVertexBuffer9 介面完成時,無法呼叫 IUnknown::Release 會導致記憶體流失。

規格需求

需求
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9

IDirect3DDevice9::DrawIndexedPrimitive

IDirect3DDevice9::DrawIndexedPrimitiveUP

IDirect3DDevice9::DrawPrimitive

IDirect3DDevice9::DrawPrimitiveUP

IDirect3DDevice9::SetStreamSource

(Direct3D 9) 頂點緩衝區