IDXGISurface::Map 方法 (dxgi.h)

获取指向图面中包含的数据的指针,并拒绝 GPU 访问图面。

语法

HRESULT Map(
  [out] DXGI_MAPPED_RECT *pLockedRect,
        UINT             MapFlags
);

参数

[out] pLockedRect

类型: DXGI_MAPPED_RECT*

指向图面数据的指针, (看到 DXGI_MAPPED_RECT) 。

MapFlags

类型: UINT

CPU 读写标志。 这些标志可以与逻辑 OR 组合使用。

  • DXGI_MAP_READ - 允许 CPU 读取访问。
  • DXGI_MAP_WRITE - 允许 CPU 写入访问。
  • DXGI_MAP_DISCARD - 映射资源时放弃以前的内容。

返回值

类型: HRESULT

如果成功,则返回S_OK;否则,返回 DXGI_ERROR 主题中描述的错误代码之一。

备注

使用 IDXGISurface::Map 从 CPU 访问图面。 若要释放映射的图面 (并允许 GPU 访问) 调用 IDXGISurface::Unmap

要求

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

另请参阅

IDXGISurface