IHolographicCameraRenderingParametersInterop：：CommitDirect3D12ResourceWithDepthData 方法 (windows.graphics.holographic.interop.h)

提交 Direct3D 12 缓冲区，以便在与 HolographicCamera 关联的输出上演示。 缓冲区必须已通过在提交的同一 HolographicCamera 上调用 CreateDirect3D12BackBufferResource 或 CreateDirect3D12HardwareProtectedBackBufferResource 来创建。

此方法还接受可选的深度缓冲区参数，以及该缓冲区上应用工作完成的围栏和围栏值。 此深度缓冲区在显示它所提交到的帧时，将用于图像稳定。 深度缓冲区必须包含与用于在同时提交的颜色缓冲区中绘制全息影像的几何图形相关的深度数据。 深度缓冲区不应包含不可见内容的深度数据，例如用于遮挡的深度数据。

语法

HRESULT CommitDirect3D12ResourceWithDepthData(
  ID3D12Resource *pColorResourceToCommit,
  ID3D12Fence    *pColorResourceFence,
  UINT64         colorResourceFenceSignalValue,
  ID3D12Resource *pDepthResourceToCommit,
  ID3D12Fence    *pDepthResourceFence,
  UINT64         depthResourceFenceSignalValue
);

参数

pColorResourceToCommit

类型： ID3D12Resource*

显示用于检索此呈现参数对象的 全息帧 时要显示内容的 Direct3D 12 纹理资源。

pColorResourceFence

类型： ID3D12Fence*

用于在 pColorResourceToCommit 指示的颜色缓冲区资源上指示应用工作完成的围栏。 在 colorResourceFenceSignalValue 指示的值处完成此围栏表示将颜色资源的控制权从应用程序转移到 GPU 工作队列中的平台。 平台依赖于此围栏以及 colorResourceFenceSignalValue 中指示的值，在从颜色缓冲区读取的 GPU 上对工作进行排队。

colorResourceFenceSignalValue

类型： UINT64

用于在 pColorResourceFence 上指示工作完成的值。 平台依赖此围栏值在从颜色缓冲区读取的 GPU 上对工作进行排队。

pDepthResourceToCommit

类型： ID3D12Resource*

Direct3D 12 深度缓冲区，其中包含深度数据，用于在呈现用于检索此呈现参数对象的 全息帧 时用于图像稳定。 应用程序通常提交呈现到 pColorResourceToCommit 时使用的深度模具，或从同一呈现阶段派生的深度缓冲区。 深度缓冲区应仅包含与用于在颜色缓冲区中呈现全息影像的几何图形对应的数据;例如，不应包含遮挡数据，并且可能被平台忽略。

pDepthResourceFence

类型： ID3D12Fence*

用于指示 pDepthResourceToCommit 指示的深度缓冲区资源上的工作完成的围栏。 在 depthResourceFenceSignalValue 指示的值处完成此围栏表示将深度资源的控制权从应用程序转移到 GPU 工作队列中的平台。 平台依赖于此围栏以及 colorResourceFenceSignalValue 中指示的值，在从深度缓冲区读取的 GPU 上对工作进行排队。

depthResourceFenceSignalValue

类型： UINT64

用于在 pDepthResourceFence 上发出工作完成信号的值。 平台依赖此围栏值在从深度缓冲区读取的 GPU 上对工作进行排队。

返回值

如果 成功，S_OK，否则返回指示失败原因的 HRESULT 错误代码。 另请参阅 COM 错误代码 (UI、音频、DirectX、编解码器) 。

要求

要求	值
最低受支持的客户端	Windows 10，版本 2004 (10.0;内部版本 19041)
最低受支持的服务器	Windows Server 版本 2004 (10.0;内部版本 19041)
标头	windows.graphics.holographic.interop.h