Metodo ID3DXEffect::Begin

Avvia una tecnica attiva.

Sintassi

HRESULT Begin(
  [out] UINT  *pPasses,
  [in]  DWORD Flags
);

Parametri

pPasses [out]

Tipo: UINT*

Puntatore a un valore restituito che indica il numero di passaggi necessari per eseguire il rendering della tecnica corrente.

Flag [in]

Tipo: DWORD

DWORD che determina se lo stato modificato da un effetto viene salvato e ripristinato. Il valore predefinito 0 specifica che ID3DXEffect::Begin e ID3DXEffect:: End salva e ripristina tutti gli stati modificati dall'effetto (incluse costanti pixel e vertex shader). I flag validi possono essere visualizzati in Salva stato effetto e ripristina flag.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Commenti

Un'applicazione imposta una tecnica attiva nel sistema effetto chiamando ID3DXEffect::Begin. Il sistema degli effetti risponde acquisisce tutto lo stato della pipeline che può essere modificato dalla tecnica in un blocco di stato. Un'applicazione segnala la fine di una tecnica chiamando ID3DXEffect::End, che usa il blocco di stato per ripristinare lo stato originale. Il sistema di effetto, pertanto, si occupa dello stato di salvataggio quando una tecnica diventa attiva e ripristina lo stato quando termina una tecnica. Se si sceglie di disabilitare questa funzionalità di salvataggio e ripristino, vedere D3DXFX_DONOTSAVESAMPLERSTATE.

All'interno della coppia ID3DXEffect::Begin e ID3DXEffect::End, un'applicazione usa ID3DXEffect::BeginPass per impostare il passaggio attivo, ID3DXEffect::CommitChanges se si verificano modifiche dello stato dopo l'attivazione del passaggio e ID3DXEffect::EndPass per terminare il passaggio attivo.

Requisiti

Vedi anche

ID3DXEffect