ID3D12Resource::ReadFromSubresource 方法 (d3d12.h)

使用 CPU 从子资源复制数据,使 CPU 能够读取具有未定义布局的大多数纹理的内容。

语法

HRESULT ReadFromSubresource(
  [out]          void            *pDstData,
                 UINT            DstRowPitch,
                 UINT            DstDepthPitch,
                 UINT            SrcSubresource,
  [in, optional] const D3D12_BOX *pSrcBox
);

参数

[out] pDstData

类型: void*

指向内存中目标数据的指针。

DstRowPitch

类型: UINT

从一行目标数据到下一行的距离。

DstDepthPitch

类型: UINT

目标数据一个深度切片到下一个深度切片的距离。

SrcSubresource

类型: UINT

指定要从中读取的子资源的索引。

[in, optional] pSrcBox

类型: const D3D12_BOX*

指向框的指针,该框定义要从其复制资源数据的目标子资源部分。 如果为 NULL,则从目标子资源读取数据,且没有偏移量。 目标的尺寸必须符合目标 (D3D12_BOX)

空框导致无操作。 如果顶部值大于或等于底部值,或者左值大于或等于右值,或者前值大于或等于后的值,则框为空。 当框为空时,此方法不执行任何操作。

返回值

类型: HRESULT

此方法返回 Direct3D 12 返回代码之一。

备注

请参阅 WriteToSubresource 的“备注”部分。

要求

   
目标平台 Windows
标头 d3d12.h
Library D3d12.lib
DLL D3d12.dll

另请参阅

ID3D12Resource

子资源