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 は 、ポイント サンプリングを使用してストレッチと圧縮を実行します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dxgi1_2.h |
| Library | DXGI.lib |