IDirect3DDevice9Ex::CheckDeviceState-Methode (d3d9.h)
Meldet den aktuellen Status auf kooperativer Ebene des Direct3D-Geräts für eine Fenster- oder Vollbildanwendung.
Syntax
HRESULT CheckDeviceState(
[in] HWND hDestinationWindow
);
Parameter
[in] hDestinationWindow
Typ: HWND
Der Zielfensterpunkt, um nach Okklusion zu suchen. Wenn dieser Parameter NULL ist, wird S_PRESENT_OCCLUDED zurückgegeben, wenn ein anderes Gerät den Vollbildbesitz besitzt. Wenn der Fensterziehpunkt nicht NULL ist, wird der Clientbereich des Fensters auf Okklusion überprüft. Ein Fenster wird ausgeblendet, wenn ein Teil davon von einer anderen Anwendung verdeckt wird.
Rückgabewert
Typ: HRESULT
Mögliche Rückgabewerte sind: D3D_OK, D3DERR_DEVICELOST, D3DERR_DEVICEHUNG, D3DERR_DEVICEREMOVED oder D3DERR_OUTOFVIDEOMEMORY (siehe D3DERR) oder S_PRESENT_MODE_CHANGED oder S_PRESENT_OCCLUDED (siehe S_PRESENT).
Hinweise
Diese Methode ersetzt IDirect3DDevice9::TestCooperativeLevel, die immer S_OK in Direct3D 9Ex-Anwendungen zurückgibt.
Es wird empfohlen, checkDeviceState nicht jeden Frame aufzurufen. Rufen Sie stattdessen CheckDeviceState nur auf, wenn die IDirect3DDevice9Ex::P resentEx-Methode einen Fehlercode zurückgibt.
Weitere Informationen zu verlorenen Geräten, hängen und entfernten Geräten finden Sie unter "Änderungen am Verlorenen Geräteverhalten ".
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d9.h |
| Bibliothek | D3D9.lib |