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

Weitere Informationen

IDirect3DDevice9Ex