D3DHAL_DP2TEXTURESTAGESTATE struttura (d3dhal.h)

Una o più strutture D3DHAL_DP2TEXTURESTAGESTATE vengono analizzate dal buffer dei comandi dal callback D3dDrawPrimitives2 quando il membro bCommand della struttura di D3DHAL_DP2COMMAND è impostato su D3DDP2OP_TEXTURESTAGESTATE e viene usato per impostare lo stato di fase di trama appropriato.

Sintassi

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

Members

wStage

Identifica la fase della trama in cui aggiornare lo stato della trama. Questo membro può essere un intero nell'intervallo da 0 a 7, con la trama numerata più alta più vicina al buffer del frame.

TSState

Specifica un valore enumerato D3DTEXTURESTAGESTATETYPE che specifica lo stato della trama da aggiornare. Le applicazioni DirectX 9.0 e versioni successive possono usare valori nell'enumerazione D3DSAMPLERSTATETYPE per controllare le caratteristiche degli stati di rendering correlati alla trama di sampler. 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'esempio in modalità utente (D3DSAMP_Xxx) ai valori della modalità kernel D3DTSS_Xxx in modo che i driver non siano necessari per elaborare gli stati dell'sampler 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 .

Commenti

D3dDrawPrimitives2 deve elaborare le 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 per riflettere il nuovo valore basato su TSState.

I driver che non supportano il multitexturing devono implementare il supporto solo per la fase di trama 0.

La figura seguente mostra una parte di un buffer di comando di esempio contenente un comando D3DDP2OP_TEXTURESTAGESTATE e tre strutture D3DHAL_DP2TEXTURESTAGESTATE. Il driver deve aggiornare le fasi zero e tre dello stato della trama privata di conseguenza.

Requisiti

Requisito	Valore
Intestazione	d3dhal.h (include D3dhal.h)

Vedi anche

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2