ID3DXEffect::BeginPass-Methode

Startet einen Durchlauf innerhalb der aktiven Technik.

Syntax

HRESULT BeginPass(
  [in] UINT Pass
);

Parameter

Übergeben [ In]

Typ: UINT

Ein nullbasierter ganzzahliger Index in die Technik.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, lautet der Rückgabewert D3D _ OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA.

Hinweise

Eine Anwendung legt einen aktiven Durchlauf (innerhalb einer aktiven Technik) im Effektsystem fest, indem ID3DXEffect::BeginPass aufgerufen wird. Eine Anwendung signalisiert das Ende des aktiven Durchlaufs, indem sie ID3DXEffect::EndPassaufruft. ID3DXEffect::BeginPass und ID3DXEffect::EndPass müssen in einem übereinstimmenden Paar innerhalb eines übereinstimmenden Paars von ID3DXEffect::Begin- und ID3DXEffect::End-Aufrufen auftreten.

Wenn die Anwendung einen Effektzustand mithilfe einer der Effect::Setx-Methoden innerhalb eines ID3DXEffect::BeginPass / ID3DXEffect::EndPass-Abgleichspaars ändert, muss die Anwendung ID3DXEffect::CommitChanges aufrufen, um das Gerät mit den Zustandsänderungen zu aktualisieren. Wenn innerhalb eines ID3DXEffect::BeginPass- und ID3DXEffect::EndPass-Paars keine Zustandsänderungen auftreten, ist es nicht erforderlich, ID3DXEffect::CommitChanges aufzurufen.

Anforderungen

Anforderung Wert
Header
D3DX9Effect.h
Bibliothek
D3dx9.lib

Siehe auch

ID3DXEffect