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 |