estructura D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)

Artículo
03/08/2023

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.