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.
Requisitos
Requisito | Valor |
---|---|
Cabeçalho | d3dhal.h (inclua D3dhal.h) |
Confira também
D3DDP2OP_TEXTURESTAGESTATE