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

[Direct3D 11.1 以降では、現在の表示サーフェイスを 取得するために GetDisplaySurfaceData を使用しないことをお勧めします。 代わりに、ステレオ表示モードをサポートする IDXGIOutput1::GetDisplaySurfaceData1 を使用します。

現在の表示サーフェイスのコピーを取得します。

構文

HRESULT GetDisplaySurfaceData(
  [in] IDXGISurface *pDestination
);

パラメーター

[in] pDestination

種類: IDXGISurface*

宛先サーフェスへのポインター ( 「IDXGISurface」を参照)。

戻り値

型: HRESULT

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

解説

IDXGIOutput::GetDisplaySurfaceData は、出力が全画面表示モードの場合にのみ呼び出すことができます。 メソッドが成功すると、DXGI によって変換先サーフェスが塗りつぶされます。

IDXGIOutput::GetDesc を使用して、出力先サーフェスの領域を割り当てるときに、出力のサイズ (幅と高さ) を決定します。 これは、ターゲット モニターの回転に関係なく当てはまります。 グラフィックス コンポーネント (Direct3D 10 など) によって作成される変換先サーフェスは、CPU 書き込みアクセス許可を使用して作成する必要があります (D3D10_CPU_ACCESS_WRITEを参照)。 他のサーフェスは、CPU 読み取り/書き込みアクセス許可を使用して作成する必要があります (「D3D10_CPU_ACCESS_READ_WRITE」を参照)。 このメソッドは、変換先のサーフェスに合わせてサーフェス データを変更します (ストレッチ、縮小、書式の変換、回転)。 ストレッチと圧縮は、ポイント サンプリングを使用して実行されます。

要件

関連項目

DXGI インターフェイス

IDXGIOutput