D3DHAL_DP2SETSTREAMSOURCEUM 結構 (d3dhal.h)

發行項
02/25/2024

僅限 DirectX 8.0 和更新版本。

D3DHAL_DP2SETSTREAMSOURCEUM 結構可用來將頂點數據流來源系結至 D3dDrawPrimitives2 的使用者記憶體緩衝區。

語法

typedef struct _D3DHAL_DP2SETSTREAMSOURCEUM {
  DWORD dwStream;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCEUM;

成員

dwStream

指定所系結的數據流。針對 DirectX 8.0，它一律為零。

dwStride

以位元組為單位指定頂點大小。

備註

除了將數據流系結至頂點緩衝區之外，還可以在用戶記憶體中提供數據流零的頂點數據， (UM) 緩衝區。在此情況下，會使用另一個 DP2 令牌來通知驅動程式數據流系結。該令牌D3DDP2OP_SETSTREAMSOURCEUM。

DirectX 8.0 不支援具有使用者提供的緩衝區而非頂點緩衝區的多個頂點數據流。此外，您無法將使用者記憶體緩衝區與頂點緩衝區混合。提供使用者記憶體緩衝區時，它保證為數據流零，而且是後續繪圖基本類型應該存取的唯一數據流。當使用者記憶體緩衝區系結至數據流時，其他數據流可能會有非 NULL 頂點緩衝區系結至它們。不過，驅動程式和硬體必須忽略這些其他數據流。

實際繪製基本類型時，應該從傳遞的D3DHAL_DRAWPRIMITIVES2DATA 擷取頂點數據的實際使用者記憶體指標。