IDCompositionDevice::CheckDeviceState-Methode (dcomp.h)

Bestimmt, ob das DirectComposition-Geräteobjekt noch gültig ist.

Syntax

HRESULT CheckDeviceState(
  [out] BOOL *pfValid
);

Parameter

[out] pfValid

TRUE, wenn das DirectComposition-Geräteobjekt noch gültig ist; andernfalls FALSE.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Wenn das DXGI-Gerät (Microsoft DirectX Graphics Infrastructure) verloren geht, geht auch das dem DXGI-Gerät zugeordnete DirectComposition-Gerät verloren. Wenn ein verloren gegangenes Gerät erkannt wird, sendet DirectComposition die WM_PAINT-Nachricht an alle Fenster, die DirectComposition-Inhalte mithilfe des verlorenen Geräts verfassen. Eine Anwendung sollte CheckDeviceState als Antwort auf jede WM_PAINT Nachricht aufrufen, um sicherzustellen, dass das DirectComposition-Geräteobjekt weiterhin gültig ist. Die Anwendung muss Schritte zum Wiederherstellen von Inhalten ausführen, wenn das Geräteobjekt ungültig wird. Die Schritte umfassen das Erstellen neuer DXGI- und DirectComposition-Geräte sowie das erneute Erstellen aller Inhalte. (Es ist nicht möglich, nur ein neues DXGI-Gerät zu erstellen und es dem vorhandenen DirectComposition-Gerät zuzuordnen.) Das System stellt sicher, dass das Geräteobjekt zwischen WM_PAINT Nachrichten gültig bleibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dcomp.h
Bibliothek	Dcomp.lib
DLL	Dcomp.dll

Weitere Informationen

IDCompositionDevice