IDCompositionDevice：：CheckDeviceState 方法 (dcomp.h)

  • 發行項

判斷 DirectComposition 裝置物件是否仍然有效。

語法

HRESULT CheckDeviceState(
  [out] BOOL *pfValid
);

參數

[out] pfValid

如果 DirectComposition 裝置物件仍然有效，則為 TRUE;否則為 FALSE。

傳回值

如果函式成功，它會傳回S_OK。 否則，它會傳回 HRESULT 錯誤碼。 如需錯誤碼的清單，請參閱 DirectComposition 錯誤 碼。

備註

如果 Microsoft DirectX 圖形基礎結構 (DXGI) 裝置遺失，則與 DXGI 裝置相關聯的 DirectComposition 裝置也會遺失。 當偵測到遺失的裝置時，DirectComposition 會將 WM_PAINT 訊息傳送至使用遺失裝置撰寫 DirectComposition 內容的所有視窗。 應用程式應該呼叫 CheckDeviceState ，以回應每個 WM_PAINT 訊息，以確保 DirectComposition 裝置物件仍然有效。 如果裝置物件變成無效，應用程式必須採取步驟來復原內容。 步驟包括建立新的 DXGI 和 DirectComposition 裝置，以及重新建立所有內容。 (您無法只建立新的 DXGI 裝置，並將它與現有的 DirectComposition device 建立關聯。) 系統可確保裝置物件在 WM_PAINT 訊息之間保持有效。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 dcomp.h
程式庫 Dcomp.lib
Dll Dcomp.dll

另請參閱

IDCompositionDevice