Share via


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) 。 此方法會修改介面資料,以符合目的地介面 (延展、壓縮、轉換格式、旋轉) 。 延展和壓縮是使用點取樣來執行。

需求

   
目標平台 Windows
標頭 dxgi.h
程式庫 DXGI.lib

另請參閱

DXGI 介面

IDXGIOutput