Partilhar via


estrutura D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)

Uma ou mais estruturas D3DHAL_DP2TEXTURESTAGESTATE são analisadas do buffer de comando pelo D3dDrawPrimitives2 retorno de chamada quando o membro bCommand da estrutura D3DHAL_DP2COMMAND está definido como D3DDP2OP_TEXTURESTAGESTATE e é usado 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 anterior, esses estados de amostragem foram incluídos na enumeração D3DTEXTURESTAGESTATETYPE. O runtime mapeia os estados do sampler do modo de usuário (D3DSAMP_Xxx) para os valores D3DTSS_xxx de modo 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 ao qual o driver deve atualizar o estado de textura identificado por TSState.

Observações

D3dDrawPrimitives2 deve processar estruturas de wStateCount D3DHAL_DP2TEXTURESTAGESTATE do buffer de comando. O valor de wStateCount é especificado na estrutura de 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.

Drivers que não dão suporte à multitextaçã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 que contém 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 D3DHAL_DP2TEXTURESTAGESTATE

Requisitos

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

Consulte também

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2