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 |