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

Siehe auch

ID3DXEffect