Método ID3DXEffect::Begin

Inicia uma técnica ativa.

Sintaxe

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

Parâmetros

pPasses [out]

Tipo: UINT*

Ponteiro para um valor retornado que indica o número de passes necessários para renderizar a técnica atual.

Sinalizadores [in]

Tipo: DWORD

DWORD que determina se o estado modificado por um efeito é salvo e restaurado. O valor padrão 0 especifica que ID3DXEffect::Begin e ID3DXEffect::End salvarão e restaurarão todo o estado modificado pelo efeito (incluindo constantes de sombreador de pixel e vértice). Sinalizadores válidos podem ser vistos em Sinalizadores de Salvamento e Restauração do Estado de Efeito.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentários

Um aplicativo define uma técnica ativa no sistema de efeito chamando ID3DXEffect::Begin. O sistema de efeito responde capturando todo o estado do pipeline que pode ser alterado pela técnica em um bloco de estado. Um aplicativo sinaliza o fim de uma técnica chamando ID3DXEffect::End, que usa o bloco de estado para restaurar o estado original. O sistema de efeito, portanto, cuida de salvar o estado quando uma técnica se torna ativa e restaura o estado quando uma técnica termina. Se você optar por desabilitar essa funcionalidade de salvamento e restauração, consulte D3DXFX_DONOTSAVESAMPLERSTATE.

Dentro do par ID3DXEffect::Begin e ID3DXEffect::End , um aplicativo usa ID3DXEffect::BeginPass para definir a passagem ativa, ID3DXEffect::CommitChanges se alguma alteração de estado ocorreu depois que a passagem foi ativada e ID3DXEffect::EndPass para encerrar o passe ativo.

Requisitos

Requisito	Valor
parâmetro	D3DX9Effect.h
Biblioteca	D3dx9.lib

Confira também

ID3DXEffect