ID3DXEffect::BeginPass-Methode
Beginnt einen Durchlauf innerhalb der aktiven Technik.
Syntax
HRESULT BeginPass(
[in] UINT Pass
);
Parameter
-
Pass [in]
-
Typ: UINT
Ein nullbasierter ganzzahliger Index in das Verfahren.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Bemerkungen
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 ID3DXEffect::EndPass aufgerufen wird. ID3DXEffect::BeginPass und ID3DXEffect::EndPass müssen in einem übereinstimmenden Paar 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-Übereinstimmungspaars ändert, muss die Anwendung ID3DXEffect::CommitChanges aufrufen, um das Update des Geräts mit den Zustandsänderungen festzulegen. Wenn innerhalb eines ID3DXEffect::BeginPass - und ID3DXEffect:: EndPass-Übereinstimmungspaars keine Zustandsänderungen auftreten, ist es nicht erforderlich , ID3DXEffect::CommitChanges aufzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch