IDirect3DDevice9Ex::CheckDeviceState-Methode (d3d9.h)
Meldet die aktuelle status auf Kooperativer Ebene des Direct3D-Geräts für eine Anwendung mit Fenstern oder Vollbild.
Syntax
HRESULT CheckDeviceState(
[in] HWND hDestinationWindow
);
Parameter
[in] hDestinationWindow
Typ: HWND
Das Zielfensterhandle, das auf Okklusion überprüft werden soll. Wenn dieser Parameter NULL ist, wird S_PRESENT_OCCLUDED zurückgegeben, wenn ein anderes Gerät den Vollbildbesitz besitzt. Wenn das Fensterhandle nicht NULL ist, wird der Clientbereich des Fensters auf Okklusion überprüft. Ein Fenster wird verdeckt, 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 in Direct3D 9Ex-Anwendungen immer S_OK zurückgibt.
Es wird empfohlen, CheckDeviceState nicht in jedem Frame aufzurufen. Rufen Sie stattdessen CheckDeviceState nur auf, wenn die IDirect3DDevice9Ex::P resentEx-Methode einen Fehlercode zurückgibt.
Weitere Informationen zu verlorenen, hängenden und entfernten Geräten finden Sie unter Verhaltensänderungen für verlorene Geräte.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d9.h |
| Bibliothek | D3D9.lib |