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 |
|
| Bibliothek |
|