struttura D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)
Una o più strutture D3DHAL_DP2TEXTURESTAGESTATE vengono analizzate dal buffer dei comandi dal D3dDrawPrimitives2 callback quando il membro della struttura D3DHAL_DP2COMMAND bCommand viene impostato su D3DDP2OP_TEXTURESTAGESTATE e viene usato per impostare lo stato della fase di trama appropriato.
Sintassi
typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
WORD wStage;
WORD TSState;
DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;
Membri
wStage
Identifica la fase della trama in cui aggiornare lo stato della trama. Questo membro può essere un numero intero compreso nell'intervallo compreso tra 0 e 7, con la trama numerata più alta più vicina al buffer dei fotogrammi.
TSState
Specifica un D3DTEXTURESTAGESTATETYPE valore enumerato che specifica lo stato della trama da aggiornare. Le applicazioni DirectX 9.0 e successive possono usare valori nell'enumerazione D3DSAMPLERSTATETYPE per controllare le caratteristiche degli stati di rendering correlati alle trame del campionatore. In DirectX 8.0 e versioni precedenti, questi stati di sampler sono stati inclusi nell'enumerazione D3DTEXTURESTAGESTATETYPE. Il runtime esegue il mapping degli stati dell'campionatore in modalità utente (D3DSAMP_Xxx) ai valori D3DTSS_xxx in modo che i driver non siano necessari per elaborare gli stati di campionatore in modalità utente. Per altre informazioni su D3DTEXTURESTAGESTATETYPE e D3DSAMPLERSTATETYPE, vedere la documentazione di DirectX SDK.
dwValue
Specifica il valore a cui il driver deve aggiornare lo stato della trama identificato da TSState.
Osservazioni
D3dDrawPrimitives2 deve elaborare strutture wStateCount D3DHAL_DP2TEXTURESTAGESTATE dal buffer dei comandi. Il valore di wStateCount viene specificato nella struttura D3DHAL_DP2COMMAND.
Per ogni struttura D3DHAL_DP2TEXTURESTAGESTATE, D3dDrawPrimitives2 deve aggiornare lo stato interno della trama del driver associato alla trama in dwStage in modo da riflettere il nuovo valore basato su TSState.
I driver che non supportano il multitexturing devono implementare il supporto solo per la fase 0 della trama.
La figura seguente mostra una parte di un buffer dei comandi di esempio contenente un comando D3DDP2OP_TEXTURESTAGESTATE e tre strutture D3DHAL_DP2TEXTURESTAGESTATE. Il driver deve aggiornare le fasi zero e tre dello stato della fase di trama privata di conseguenza.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | d3dhal.h (include D3dhal.h) |
Vedere anche
D3DDP2OP_TEXTURESTAGESTATE