IDirect3DDevice9::TestCooperativeLevel-Methode (d3d9.h)
Meldet die aktuelle status des Direct3D-Geräts auf kooperativer Ebene für eine Anwendung im Fenster- oder Vollbildmodus.
Syntax
HRESULT TestCooperativeLevel();
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK, was angibt, 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 verlorenes Gerät erkennt, sollte sie IDirect3DDevice9::TestCooperativeLevel in regelmäßigen Abständen aufrufen, bis sie den Rückgabewert D3DERR_DEVICENOTRESET erhält. Die Anwendung kann dann versuchen, das Gerät zurückzusetzen, indem sie IDirect3DDevice9::Reset aufruft , und wenn dies erfolgreich ist, die erforderlichen Ressourcen wiederherzustellen und den normalen Betrieb fortzusetzen. 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 in einem anderen Thread aufgerufen wird als der, der zum Erstellen des zurückgesetzten Geräts verwendet wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |