IDXGISwapChain::ResizeTarget メソッド (dxgi.h)

  • [アーティクル]

出力ターゲットのサイズを変更します。

構文

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

パラメーター

[in] pNewTargetParameters

型: const DXGI_MODE_DESC*

ターゲット の新 しい幅、高さ、形式、更新レートを指定するモードを記述するDXGI_MODE_DESC構造体へのポインター。 形式が DXGI_FORMAT_UNKNOWNの場合、 ResizeTarget は既存の形式を使用します。 スワップ チェーンが全画面表示モードの場合にのみ 、DXGI_FORMAT_UNKNOWN を使用することをお勧めします。このメソッドはスレッド セーフではありません。

戻り値

型: HRESULT

成功または失敗を示すコードを返します。 この API の呼び出し時に全画面表示/ウィンドウ モードの切り替えが行われている場合は、DXGI_STATUS_MODE_CHANGE_IN_PROGRESSが返されます。 その他の DXGI エラー コードについては、「 DXGI_ERROR 」を参照してください。

注釈

ResizeTarget は、スワップ チェーンがウィンドウ モードのときにターゲット ウィンドウのサイズを変更し、スワップ チェーンが全画面表示モードのときにターゲット出力の表示モードを変更します。 そのため、アプリは ResizeTarget を呼び出して、スワップ チェーンの表示モードを知らなくても ( SetWindowPos などの Microsoft Win32API ではなく) ターゲット ウィンドウのサイズを変更できます。

Windows ストア アプリが ResizeTarget を呼び出すと、 DXGI_ERROR_NOT_CURRENTLY_AVAILABLEで失敗します。

IDXGIFactory2::CreateSwapChainForComposition を使用して作成したスワップ チェーンで ResizeTarget を呼び出すことはできません。

ResizeBuffers のみがバック バッファーを変更できるため、ResizeTarget を呼び出した後も、アプリは IDXGISwapChain::ResizeBuffers を呼び出す必要があります。 ただし、これらのアプリが ResizeBuffers を呼び出すためにウィンドウサイズ変更処理を実装している場合、ウィンドウのサイズ変更処理によってアプリに必要なものが得られるので、ResizeTarget を呼び出した後に ResizeBuffers を明示的に呼び出す必要はありません。

要件

要件 値
対象プラットフォーム Windows
ヘッダー dxgi.h
Library DXGI.lib

こちらもご覧ください

IDXGISwapChain