Compartilhar via


estrutura D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)

Uma ou mais estruturas D3DHAL_DP2TEXTURESTAGESTATE são analisadas do buffer de comando pelo retorno de chamada D3dDrawPrimitives2 quando o membro bCommand da estrutura D3DHAL_DP2COMMAND é definido como D3DDP2OP_TEXTURESTAGESTATE e são usados para definir o estado de estágio de textura apropriado.

Sintaxe

typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
  WORD  wStage;
  WORD  TSState;
  DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;

Membros

wStage

Identifica o estágio de textura em que atualizar o estado de textura. Esse membro pode ser um inteiro no intervalo de 0 a 7, com a textura numerada mais alta sendo mais próxima do buffer de quadros.

TSState

Especifica um valor enumerado D3DTEXTURESTAGESTATETYPE que especifica o estado de textura a ser atualizado. Os aplicativos DirectX 9.0 e posteriores podem usar valores na enumeração D3DSAMPLERSTATETYPE para controlar as características dos estados de renderização relacionados à textura do sampler. No DirectX 8.0 e anteriores, esses estados de amostragem foram incluídos na enumeração D3DTEXTURESTAGESTATETYPE. O runtime mapeia os estados de amostra do modo de usuário (D3DSAMP_Xxx) para valores de D3DTSS_Xxx no modo kernel para que os drivers não sejam necessários para processar estados de sampler no modo de usuário. Para obter mais informações sobre D3DTEXTURESTAGESTATETYPE e D3DSAMPLERSTATETYPE, consulte a documentação do SDK do DirectX.

dwValue

Especifica o valor para o qual o driver deve atualizar o estado de textura identificado por TSState .

Comentários

D3dDrawPrimitives2 deve processar estruturasde D3DHAL_DP2TEXTURESTAGESTATE wStateCount do buffer de comando. O valor de wStateCount é especificado na estrutura D3DHAL_DP2COMMAND.

Para cada estrutura D3DHAL_DP2TEXTURESTAGESTATE, D3dDrawPrimitives2 deve atualizar o estado de textura interna do driver associado à textura em dwStage para refletir o novo valor com base em TSState.

Os drivers que não dão suporte à multitexção devem implementar suporte apenas para a fase de textura 0.

A figura a seguir mostra uma parte de um buffer de comando de exemplo contendo um comando D3DDP2OP_TEXTURESTAGESTATE e três estruturas de D3DHAL_DP2TEXTURESTAGESTATE. O driver deve atualizar os estágios zero e três de seu estado de estágio de textura privada adequadamente.

Figura mostrando um buffer de comando com um comando D3DDP2OP_TEXTURESTAGESTATE e três estruturas de D3DHAL_DP2TEXTURESTAGESTATE

Requisitos

Requisito Valor
Cabeçalho d3dhal.h (inclua D3dhal.h)

Confira também

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2