Share via

IDXGISwapChain::SetFullscreenState

  • [アーティクル]

表示モードをウィンドウ モードまたは全画面モードに設定します。

HRESULT 
SetFullscreenState(
  BOOL Fullscreen,
  IDXGIOutput *pTarget
);

パラメータ

  • Fullscreen
    全画面モードの場合は TRUE を使用し、ウィンドウ モードの場合は FALSE を使用します。
  • pTarget
    現在の表示モードが全画面の場合、このパラメーターは、スワップ チェーンを含む出力ターゲット (「IDXGIOutput」を参照) でなければなりません。それ以外の場合、このパラメーターは無視されます。このパラメーターを NULL に設定すると、スワップ チェーンのデバイスおよび出力ウィンドウの配置に基づいて出力が選択されます。

戻り値

このメソッドが返す値は次のとおりです。

  • 処理に成功し、要求された状態にスワップ チェーンが置かれている場合は、S_OK を返します。

  • 処理に失敗した場合は、DXGI_ERROR_NOT_CURRENTLY_AVAILABLE を返します。全画面スワップ チェーンをウィンドウ モードに切り替えられない場合、さまざまな理由があります。次に例を示します。

    • アプリケーションがターミナル サーバー経由で実行されている。
    • 出力ウィンドウが遮断されている。
    • 出力ウィンドウにキーボード フォーカスがない。
    • 他のアプリケーションが既に全画面モードになっている。

    このエラーが返された場合、アプリケーションは引き続きウィンドウ モードで稼働し、後で全画面モードへの切り替えを試行することができます。

  • メモリーが不足している場合や、別の予期しないエラーが発生した場合は、他のエラー コードが返されます。これらのコードは、継続できないハード エラーとして扱われる場合があります。

解説　

DXGI は、ユーザーまたはシステムの要求に応答して、スワップ チェーンの表示モードを変更することができます。

要件

ヘッダー: DXGI.h 宣言

ライブラリ: DXGI.lib 内容

関連項目

IDXGISwapChain