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 は、失われた デバイスを使用 して DirectComposition コンテンツを作成しているすべてのウィンドウにWM_PAINT メッセージを送信します。 DirectComposition デバイス オブジェクトが引き続き有効であることを確認するために、アプリケーションは各WM_PAINT メッセージに応答して CheckDeviceState を呼び出す必要があります。 デバイス オブジェクトが無効になった場合、アプリケーションはコンテンツを回復する手順を実行する必要があります。 手順には、新しい DXGI デバイスと DirectComposition デバイスの作成、およびすべてのコンテンツの再作成が含まれます。 (新しい DXGI デバイスのみを作成し、既存の DirectComposition デバイスに関連付けすることはできません)。システムは、 WM_PAINT メッセージ間 でデバイス オブジェクトが有効なままであることを確認します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dcomp.h |
| Library | Dcomp.lib |
| [DLL] | Dcomp.dll |