Compartilhar via


Método ID3DXEffect::BeginPass

Inicia uma passagem, dentro da técnica ativa.

Sintaxe

HRESULT BeginPass(
  [in] UINT Pass
);

Parâmetros

Passar [in]

Tipo: UINT

Um índice inteiro baseado em zero na técnica.

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 passagem ativa (dentro de uma técnica ativa) no sistema de efeito chamando ID3DXEffect::BeginPass. Um aplicativo sinaliza o fim da passagem ativa chamando ID3DXEffect::EndPass. ID3DXEffect::BeginPass e ID3DXEffect::EndPass devem ocorrer em um par correspondente, dentro de um par correspondente de chamadas ID3DXEffect::Begin e ID3DXEffect::End .

Se o aplicativo alterar qualquer estado de efeito usando qualquer um dos métodos Effect::Setx dentro de um par de correspondência ID3DXEffect::BeginPass/ID3DXEffect::EndPass , o aplicativo deverá chamar ID3DXEffect::CommitChanges para definir a atualização do dispositivo com as alterações de estado. Se nenhuma alteração de estado ocorrer em um par correspondente ID3DXEffect::BeginPass e ID3DXEffect::EndPass , não será necessário chamar ID3DXEffect::CommitChanges.

Requisitos

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

Confira também

ID3DXEffect