IDXGIFactory2::RegisterOcclusionStatusWindow メソッド (dxgi1_2.h)

オクルージョン状態の変更に関する通知メッセージを受信するアプリケーション ウィンドウを登録します。

構文

HRESULT RegisterOcclusionStatusWindow(
  [in]  HWND  WindowHandle,
  [in]  UINT  wMsg,
  [out] DWORD *pdwCookie
);

パラメーター

[in] WindowHandle

オクルージョン状態の変更が発生したときに通知メッセージを送信するウィンドウのハンドル。

[in] wMsg

送信する通知メッセージを識別します。

[out] pdwCookie

アプリケーションが IDXGIFactory2::UnregisterOcclusionStatus メソッドに渡して wMsg が指定する通知メッセージの登録を解除できるキー値へのポインター。

戻り値

RegisterOcclusionStatusWindow は次を返します。

• ウィンドウが正常に登録された場合は、S_OKします。
• 操作を完了するためにメモリが使用できない場合にE_OUTOFMEMORYします。
• WindowHandle が有効なウィンドウ ハンドルではないか、現在のプロセスが所有するウィンドウ ハンドルでない場合にDXGI_ERROR_INVALID_CALLします。
• 場合によっては、 DXGI_ERROR トピックで説明されているその他のエラー コード。

Windows 7 用プラットフォーム更新プログラム: Windows 7 用プラットフォーム更新プログラム がインストールされている Windows 7 または Windows Server 2008 R2 では、 RegisterOcclusionStatusWindow はE_NOTIMPLで失敗します。 Windows 7 用プラットフォーム更新プログラムの詳細については、「Windows 7 用プラットフォーム更新プログラム」を参照してください。

注釈

アプリは、オクルージョンの状態が変化したときに Windows が送信する Windows メッセージを選択します。

要件

要件	値
サポートされている最小のクライアント	Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	dxgi1_2.h
Library	Dxgi.lib

こちらもご覧ください

IDXGIFactory2