IDXGISwapChain_SetFullscreenState

ディスプレイ状態をウィンドウまたはフルスクリーンに設定する。

IDXGISwapChain_SetFullscreenState this, Fullscreen, pTarget

this : [comobj] IDXGISwapChain インターフェースの COM オブジェクト変数
Fullscreen : [int] 型: BOOL ディスプレイ状態をウィンドウまたはフルスクリーンに設定するかどうかを指定するブール値。フルスクリーンの場合は TRUE、ウィンドウの場合は FALSE。
pTarget : [comobj] 型: [in, optional] IDXGIOutput* Fullscreen パラメータに TRUE を渡してディスプレイ状態をフルスクリーンに設定する場合、スワップチェーンを含む出力ターゲットの IDXGIOutput インターフェースへのポインタをこのパラメータにオプションで設定できる。このパラメータを NULL に設定した場合、DXGI はスワップチェーンのデバイスと出力ウィンドウの配置に基づいて出力を選択する。Fullscreen に FALSE を渡す場合は、このパラメータを NULL に設定する必要がある。

(プラグイン / モジュール : com_misc.dll)

解説

ディスプレイ状態をウィンドウまたはフルスクリーンに設定する。

[戻り値]
型: HRESULT このメソッドは次のいずれかの値を返す。- **S_OK**
アクションが成功し、スワップチェーンが要求された状態に置かれた場合。-
**DXGI_ERROR_NOT_CURRENTLY_AVAILABLE**
アクションが失敗した場合。このエラーが返された場合、アプリケーションはウィンドウモードで実行を続け、後でフルスクリーンモードへの切り替えを試みることができる。ウィンドウモードのスワップチェーンがフルスクリーンモードに切り替えられない理由は多数ある。例:
- アプリケーションがターミナルサーバ上で実行されている。- 出力ウィンドウが遮蔽されている。-
出力ウィンドウがキーボードフォーカスを持っていない。- 別のアプリケーションがすでにフルスクリーンモードにある。-
**DXGI_STATUS_MODE_CHANGE_IN_PROGRESS** この API
が呼び出されたときにフルスクリーン/ウィンドウモードの遷移が発生している場合に返される。-
メモリ不足やその他の予期しないエラーが発生した場合の他のエラーコード。これらのコードはハードで継続不可能なエラーとして扱われる場合がある。

[備考]
DXGI
はエンドユーザーまたはシステムの要求に応じてスワップチェーンのディスプレイ状態を変更する場合がある。ウィンドウのスワップチェーンを作成し、SetFullscreenState
を介してエンドユーザーがスワップチェーンをフルスクリーンに変更できるようにすることを推奨する。つまり、スワップチェーンを強制的にフルスクリーンにするために
DXGI_SWAP_CHAIN_DESC の Windowed メンバを FALSE
に設定しないこと。ただし、スワップチェーンをフルスクリーンとして作成する場合、サポートされていないディスプレイモードで作成されたスワップチェーンはディスプレイが真っ暗になりエンドユーザーが何も見られなくなる可能性があるため、サポートされているディスプレイモードのリストもエンドユーザーに提供すること。また、エンドユーザーがディスプレイモードを変更できるようにする場合、タイムアウト確認画面やその他のフォールバックメカニズムを用意することを推奨する。Windows
ストアアプリの注意点 Windows ストアアプリが SetFullscreenState
を呼び出してディスプレイ状態をフルスクリーンに設定すると、SetFullscreenState は
DXGI_ERROR_NOT_CURRENTLY_AVAILABLE
で失敗する。IDXGIFactory2::CreateSwapChainForComposition で作成したスワップチェーンに対しては
SetFullscreenState
を呼び出せない。フリッププレゼンテーションモデルでは、ディスプレイ状態をフルスクリーンに遷移した後、IDXGISwapChain1::Present1
の呼び出しが成功するように ResizeBuffers を呼び出す必要がある。

情報