IDXGIOutput1::GetDisplaySurfaceData1 メソッド (dxgi1_2.h)

表示画面 (フロント バッファー) をユーザー指定のリソースにコピーします。

構文

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

パラメーター

[in] pDestination

GetDisplaySurfaceData1 が表示画面をコピーするリソースを表すリソース インターフェイスへのポインター。

戻り値

DXGI_ERRORトピックで説明されているエラー コードの 1 つを返します。

注釈

GetDisplaySurfaceData1 は IDXGIOutput::GetDisplaySurfaceData と似ていますが、 GetDisplaySurfaceData1 は IDXGIResource を受け取り、 IDXGIOutput::GetDisplaySurfaceData は IDXGISurface を受け取ります。

GetDisplaySurfaceData1 は、入力リソースがスワップ チェーン バッファーと等しい配列サイズ (D3D11_TEXTURE2D_DESC 構造体の ArraySize メンバー) を持つ 2D テクスチャ (ID3D11Texture2D インターフェイスで表される) でない場合にエラーを返します。

元の IDXGIOutput::GetDisplaySurfaceData と更新された GetDisplaySurfaceData1 はまったく同じように動作します。 配列サイズが 2 (ArraySize = 2) のテクスチャでは IDXGISurface が実装されないため、GetDisplaySurfaceData1 が必要でした。

GetDisplaySurfaceData1 は、出力が全画面表示モードの場合にのみ呼び出すことができます。 GetDisplaySurfaceData1 が成功すると、ターゲット リソースに入力されます。

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

要件

こちらもご覧ください

IDXGIOutput1