IDXGISwapChain_ResizeTarget

出力ターゲットをリサイズする。

IDXGISwapChain_ResizeTarget this, pNewTargetParameters

this : [comobj] IDXGISwapChain インターフェースの COM オブジェクト変数
pNewTargetParameters : [var] 型: const DXGI_MODE_DESC* モードを記述する DXGI_MODE_DESC 構造体へのポインタ。新しい幅、高さ、フォーマット、ターゲットのリフレッシュレートを指定する。フォーマットが DXGI_FORMAT_UNKNOWN の場合、ResizeTarget は既存のフォーマットを使用する。このメソッドはスレッドセーフではないため、スワップチェーンがフルスクリーンモードのときにのみ DXGI_FORMAT_UNKNOWN を使用することを推奨する。

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

解説

出力ターゲットをリサイズする。

[戻り値]
型: HRESULT 成功または失敗を示すコードを返す。この API
が呼び出されたときにフルスクリーン/ウィンドウモードの遷移が発生している場合は
DXGI_STATUS_MODE_CHANGE_IN_PROGRESS が返される。追加の DXGI エラーコードについては
DXGI_ERROR を参照。

[備考]
ResizeTarget
は、スワップチェーンがウィンドウモードの場合はターゲットウィンドウをリサイズし、スワップチェーンがフルスクリーンモードの場合はターゲット出力のディスプレイモードを変更する。したがって、アプリは、スワップチェーンのディスプレイモードを知らずに、(SetWindowPos
のような Microsoft Win32 API ではなく) ResizeTarget
を呼び出してターゲットウィンドウをリサイズできる。Windows ストアアプリが ResizeTarget
を呼び出すと、DXGI_ERROR_NOT_CURRENTLY_AVAILABLE
で失敗する。IDXGIFactory2::CreateSwapChainForComposition で作成したスワップチェーンに対しては
ResizeTarget を呼び出せない。ResizeBuffers のみがバックバッファを変更できるため、アプリは
ResizeTarget の呼び出し後も IDXGISwapChain::ResizeBuffers
を呼び出す必要がある。ただし、ResizeBuffers
を呼び出すウィンドウリサイズ処理を実装しているアプリでは、ウィンドウリサイズ処理がアプリが必要とすることを実現するため、ResizeTarget
の呼び出し後に明示的に ResizeBuffers を呼び出す必要はない。

情報