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.
Comentarios
Se notifica al controlador el enlace de un búfer de vértices a una secuencia determinada a través de un nuevo token dp2, D3DDP2OP_SETSTREAMSOURCE.
El tiempo 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 flujo especificado 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 controlador y hardware no se bloquee en este caso y que, al restaurar el estado correcto, la combinación de controlador 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 surge 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 un origen de secuencia se establece mediante una estructura D3DHAL_DP2COMMAND . Es decir, el campo wStateCount del D3DHAL_DP2COMMAND siempre es uno cuando bCommand es D3DDP2OP_SETSTREAMSOURCE.
Requisitos
Requisito | Valor |
---|---|
Header | d3dhal.h (incluya D3dhal.h) |
Consulte también
D3DDP2OP_SETSTREAMSOURCE