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 |