IDXGIOutput1：：GetDisplaySurfaceData1 方法 (dxgi1_2.h)
將顯示介面 (前端緩衝區) 複製到使用者提供的資源。
語法
HRESULT GetDisplaySurfaceData1(
[in] IDXGIResource *pDestination
);
參數
[in] pDestination
資源介面的指標，代表 GetDisplaySurfaceData1 複製顯示介面的資源。
傳回值
傳回 DXGI_ERROR 主題中所述的其中一個錯誤碼。
備註
GetDisplaySurfaceData1 類似於 IDXGIOutput：：GetDisplaySurfaceData，但 GetDisplaySurfaceData1 接受 IDXGIResource 和 IDXGIOutput：：GetDisplaySurfaceData 採用 IDXGISurface。
GetDisplaySurfaceData1 如果輸入資源不是 ID3D11Texture2D 介面所代表的 2D 紋理 () ，且數位大小 (arraySize 成員D3D11_TEXTURE2D_DESC結構) 等於交換鏈結緩衝區，則 GetDisplaySurfaceData1 會傳回錯誤。
原始 IDXGIOutput：GetDisplaySurfaceData 和更新的 GetDisplaySurfaceData1 的行為完全相同。 需要 GetDisplaySurfaceData1 ，因為數位大小等於 2 (ArraySize = 2) 的紋理不會實作 IDXGISurface。
只有在輸出處於全螢幕模式時，才可以呼叫 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 |
| 程式庫 | DXGI.lib |