IDXGIOutput::SetDisplaySurface メソッド (dxgi.h)

表示モードを変更します。

構文

HRESULT SetDisplaySurface(
  [in] IDXGISurface *pScanoutSurface
);

パラメーター

[in] pScanoutSurface

種類: IDXGISurface*

画面へのイメージのレンダリングに使用されるサーフェスへのポインター ( IDXGISurface を参照)。 サーフェスは、バック バッファー (DXGI_USAGE_BACKBUFFER) として作成されている必要があります。

戻り値

種類: HRESULT

DXGI_ERROR値のいずれかを返します。

注釈

IDXGIOutput::SetDisplaySurface はアプリケーションによって直接呼び出すべきではありません。結果は予測できないためです。 これは、全画面表示の遷移中に DXGI スワップ チェーン オブジェクトによって暗黙的に呼び出されるため、スワップ チェーン メソッドの代わりに使用しないでください。

このメソッドは、 IDXGIOutput::TakeOwnership 呼び出しと IDXGIOutput::ReleaseOwnership 呼び出しの間でのみ呼び出す必要があります。

Windows ストア アプリに関する注意事項

Windows ストア アプリで SetDisplaySurface を使用すると、 DXGI_ERROR_NOT_CURRENTLY_AVAILABLEで失敗します。

要件

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

こちらもご覧ください

IDXGIOutput