estructura D3DHAL_DP2SETSTREAMSOURCE (d3dhal.h)
DirectX 8.0 y versiones posteriores solo.
La estructura D3DHAL_DP2SETSTREAMSOURCE se usa para enlazar un origen de flujo de vértices a un búfer de vértices para D3dDrawPrimitives2.
Sintaxis
typedef struct _D3DHAL_DP2SETSTREAMSOURCE {
DWORD dwStream;
DWORD dwVBHandle;
DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCE;
Miembros
dwStream
Especifica la secuencia enlazada. Tiene un valor entre cero y el número máximo de secuencias especificadas por el controlador.
dwVBHandle
Especifica el identificador del búfer de vértices. Es legal que el identificador del búfer de vértices sea cero, en cuyo caso la secuencia ya no está enlazada a un búfer de vértices.
dwStride
Especifica el tamaño del vértice en bytes.
Observaciones
Un controlador recibe una notificación del enlace de un búfer de vértices a una secuencia determinada a través de un nuevo token dp2, D3DDP2OP_SETSTREAMSOURCE.
El entorno de ejecución de depuración valida que dwStream está dentro del intervalo legal, pero la versión comercial no, por lo que la validación debe estar presente en el controlador. DirectX 8.0 no define el comportamiento del controlador o hardware en el caso de error en el que el índice de secuencia dado es mayor que el flujo máximo admitido por el hardware (como se indica a través de MaxStreams en D3DCAPS8) más allá de requerir que la combinación de controladores y hardware no se produzca un error o se bloquee en este caso y eso, en la restauración del estado correcto, la combinación de controladores y hardware debe seguir funcionando con normalidad. Las versiones de depuración del controlador de pantalla deben mostrar mensajes en el flujo de salida de depuración que indica cuándo se ha detectado este problema.
El tiempo de ejecución no valida que las secuencias a las que accede el sombreador de vértices actual no sean NULL. Es responsabilidad del escritor de controladores asegurarse de que el controlador o hardware no se bloquea cuando se produce este caso de error. Las versiones de depuración del controlador de pantalla deben mostrar mensajes en el flujo de salida de depuración para indicar cuándo se ha detectado este problema.
Solo una estructura de D3DHAL_DP2COMMAND establece un origen de flujo único. Es decir, el campo wStateCount del D3DHAL_DP2COMMAND siempre es uno cuando D3DDP2OP_SETSTREAMSOURCE bCommand.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | d3dhal.h (incluya D3dhal.h) |
Consulte también
D3DDP2OP_SETSTREAMSOURCE