estructura D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)
Una o varias estructuras de D3DHAL_DP2TEXTURESTAGESTATE se analizan desde el búfer de comandos mediante la devolución de llamada D3dDrawPrimitives2 cuando el miembro bCommand de la estructura D3DHAL_DP2COMMAND se establece en D3DDP2OP_TEXTURESTAGESTATE y se usa para establecer el estado de fase de textura adecuado.
Sintaxis
typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
WORD wStage;
WORD TSState;
DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;
Miembros
wStage
Identifica la fase de textura en la que se va a actualizar el estado de textura. Este miembro puede ser un entero del intervalo comprendido entre 0 y 7, con la textura numerada más alta más cercana al búfer de fotogramas.
TSState
Especifica un valor enumerado D3DTEXTURESTAGESTATETYPE que especifica el estado de textura que se va a actualizar. Las aplicaciones directX 9.0 y posteriores pueden usar valores en la enumeración D3DSAMPLERSTATETYPE para controlar las características de los estados de representación relacionados con la textura del muestreador. En DirectX 8.0 y versiones anteriores, estos estados de muestreo se incluyeron en la enumeración D3DTEXTURESTAGESTATETYPE. El tiempo de ejecución asigna los estados del sampler en modo de usuario (D3DSAMP_Xxx) al modo kernel D3DTSS_Xxx para que los controladores no sean necesarios para procesar los estados del sampler en modo de usuario. Para más información sobre D3DTEXTURESTAGESTATETYPE y D3DSAMPLERSTATETYPE, consulte la documentación del SDK de DirectX.
dwValue
Especifica el valor al que el controlador debe actualizar el estado de textura identificado por TSState .
Comentarios
D3dDrawPrimitives2 debe procesar las estructuras de wStateCount D3DHAL_DP2TEXTURESTAGESTATE desde el búfer de comandos. El valor de wStateCount se especifica en la estructura D3DHAL_DP2COMMAND.
Para cada estructura de D3DHAL_DP2TEXTURESTAGESTATE, D3dDrawPrimitives2 debe actualizar el estado de textura interno del controlador asociado a la textura en dwStage para reflejar el nuevo valor basado en TSState.
Los controladores que no admiten multitexturing solo deben implementar compatibilidad con la fase de textura 0.
En la ilustración siguiente se muestra una parte de un búfer de comandos de ejemplo que contiene un comando D3DDP2OP_TEXTURESTAGESTATE y tres estructuras de D3DHAL_DP2TEXTURESTAGESTATE. El controlador debe actualizar las fases cero y tres de su estado de fase de textura privado en consecuencia.
Requisitos
Requisito | Valor |
---|---|
Header | d3dhal.h (incluya D3dhal.h) |
Consulte también
D3DDP2OP_TEXTURESTAGESTATE