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

Weitere Informationen

IDCompositionDevice