D3DHAL_DP2SETSTREAMSOURCEUM 结构 (d3dhal.h)

项目
08/07/2023

仅限 DirectX 8.0 及更高版本。

D3DHAL_DP2SETSTREAMSOURCEUM结构用于将顶点流源绑定到 D3dDrawPrimitives2 的用户内存缓冲区。

语法

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

成员

dwStream

指定要绑定的流。对于 DirectX 8.0，它始终为零。

dwStride

指定顶点大小（以字节为单位）。

注解

除了将流绑定到顶点缓冲区外，还可以在用户内存中提供流 0 的顶点数据， (UM) 缓冲区。在这种情况下，另一个 DP2 令牌用于通知驱动程序流绑定。该令牌是D3DDP2OP_SETSTREAMSOURCEUM。

DirectX 8.0 不支持具有用户提供的缓冲区而不是顶点缓冲区的多个顶点流。此外，无法将用户内存缓冲区与顶点缓冲区混合使用。提供用户内存缓冲区时，保证该缓冲区为流 0，并且是后续绘图基元应访问的唯一流。当用户内存缓冲区绑定到流时，其他流可能具有绑定到它们的非 NULL 顶点缓冲区。但是，驱动程序和硬件必须忽略这些其他流。

实际绘制基元时，应从传递 D3DHAL_DRAWPRIMITIVES2DATA 提取指向顶点数据的实际用户内存指针。