共用方式為

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

另請參閱

IDXGIOutput1