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 确定输出的大小 (宽度和高度) 。 无论目标监视器旋转如何,这都是正确的。 必须使用 CPU 写入权限创建由图形组件 ((如 Direct3D 10) )创建的目标图面, (请参阅D3D10_CPU_ACCESS_WRITE) 。 应使用 CPU 读写权限创建其他图面, (请参阅D3D10_CPU_ACCESS_READ_WRITE) 。 此方法将修改表面数据以适合目标表面 (拉伸、收缩、转换格式、旋转) 。 拉伸和收缩是使用点采样执行的。

要求

   
目标平台 Windows
标头 dxgi.h
Library DXGI.lib

请参阅

DXGI 接口

IDXGIOutput