Método IHolographicCameraRenderingParametersInterop::CommitDirect3D12ResourceWithDepthData (windows.graphics.holographic.interop.h)

Artigo
08/27/2023

Confirma um buffer direct3D 12 para apresentação em saídas associadas ao HolographicCamera. O buffer deve ter sido criado chamando CreateDirect3D12BackBufferResource ou CreateDirect3D12HardwareProtectedBackBufferResource no mesmo HolographicCamera para o qual ele está confirmado.

Esse método também aceita um parâmetro de buffer de profundidade opcional, juntamente com o valor de limite e limite para a conclusão do trabalho do aplicativo nesse buffer. Esse buffer de profundidade será usado para estabilização de imagem ao mostrar o quadro com o qual ele está confirmado. O buffer de profundidade deve conter dados de profundidade correlacionados com a geometria usada para desenhar hologramas no buffer de cores, que é enviado ao mesmo tempo. O buffer de profundidade não deve conter dados de profundidade para conteúdo invisível, como dados de profundidade usados para oclusão.

Sintaxe

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

Parâmetros

pColorResourceToCommit

Tipo: ID3D12Resource*

O recurso de textura Direct3D 12 com conteúdo a ser exibido ao apresentar o HolographicFrame usado para recuperar esse objeto de parâmetros de renderização.

pColorResourceFence

Tipo: ID3D12Fence*

Uma cerca usada para sinalizar a conclusão do trabalho do aplicativo no recurso de buffer de cores indicado por pColorResourceToCommit. A conclusão dessa cerca no valor indicado por colorResourceFenceSignalValue sinaliza a transferência do controle do recurso de cor do aplicativo para a plataforma na fila de trabalho de GPU. A plataforma depende dessa cerca e do valor indicado em colorResourceFenceSignalValue, para enfileirar o trabalho na GPU que lê do buffer de cores.

colorResourceFenceSignalValue

Tipo: UINT64

O valor usado para sinalizar a conclusão do trabalho em pColorResourceFence. A plataforma depende desse valor de limite para enfileirar o trabalho na GPU que lê do buffer de cores.

pDepthResourceToCommit

Tipo: ID3D12Resource*

O buffer de profundidade do Direct3D 12 com dados de profundidade a serem usados para estabilização de imagem ao apresentar o HolographicFrame usado para recuperar esse objeto de parâmetros de renderização. Os aplicativos normalmente enviam o estêncil de profundidade usado ao renderizar para pColorResourceToCommit ou um buffer de profundidade derivado da mesma passagem de renderização. O buffer de profundidade deve incluir apenas dados correspondentes à geometria usada para renderizar hologramas no buffer de cores; por exemplo, os dados de oclusão não devem ser incluídos e podem ser ignorados pela plataforma.

pDepthResourceFence

Tipo: ID3D12Fence*

Uma cerca usada para sinalizar a conclusão do trabalho no recurso de buffer de profundidade indicado por pDepthResourceToCommit. A conclusão dessa cerca no valor indicado por depthResourceFenceSignalValue sinaliza a transferência de controle do recurso de profundidade do aplicativo para a plataforma na fila de trabalho de GPU. A plataforma depende dessa cerca e do valor indicado em colorResourceFenceSignalValue, para enfileirar o trabalho na GPU que lê do buffer de profundidade.

depthResourceFenceSignalValue

Tipo: UINT64

O valor usado para sinalizar a conclusão do trabalho em pDepthResourceFence. A plataforma depende desse valor de limite para enfileirar o trabalho na GPU que lê do buffer de profundidade.

Retornar valor

S_OK se tiver êxito, caso contrário, retornará um código de erro HRESULT indicando o motivo da falha. Consulte também Códigos de erro COM (interface do usuário, áudio, DirectX, Codec).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 2004 (10.0; Build 19041)
Servidor mínimo com suporte	Windows Server, versão 2004 (10.0; Build 19041)
Cabeçalho	windows.graphics.holographic.interop.h

Share via