IDirect3DDevice9::TestCooperativeLevel-Methode (d3d9helper.h)

  • Artikel

Meldet die aktuelle status auf Kooperativer Ebene des Direct3D-Geräts für eine Anwendung mit Fenstern oder Vollbild.

Syntax

HRESULT TestCooperativeLevel();

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Dies bedeutet, dass das Gerät betriebsbereit ist und die aufrufende Anwendung fortgesetzt werden kann. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR_DEVICELOST, D3DERR_DEVICENOTRESET, D3DERR_DRIVERINTERNALERROR.

Hinweise

Wenn das Gerät verloren geht, aber zum aktuellen Zeitpunkt nicht wiederhergestellt werden kann, gibt IDirect3DDevice9::TestCooperativeLevel den D3DERR_DEVICELOST Rückgabecode zurück. Dies wäre beispielsweise der Fall, wenn ein Vollbildgerät den Fokus verloren hat. Wenn eine Anwendung ein verloren gegangenes Gerät erkennt, sollte sie angehalten und in regelmäßigen Abständen IDirect3DDevice9::TestCooperativeLevel aufrufen, bis der Rückgabewert D3DERR_DEVICENOTRESET. Die Anwendung kann dann versuchen, das Gerät zurückzusetzen, indem sie IDirect3DDevice9::Reset aufruft . Wenn dies erfolgreich ist, werden die erforderlichen Ressourcen wiederhergestellt und der normale Betrieb fortgesetzt. Beachten Sie, dass IDirect3DDevice9::P resent D3DERR_DEVICELOST zurückgibt, wenn das Gerät entweder "verloren" oder "nicht zurückgesetzt" ist.

Ein Aufruf von IDirect3DDevice9::TestCooperativeLevel schlägt fehl, wenn er in einem anderen Thread als dem zum Erstellen des zurückgesetzten Geräts aufgerufen wird.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d9helper.h (include D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9