Método IHolographicQuadLayerInterop::AcquireDirect3D12BufferResource (windows.graphics.holographic.interop.h)
O método AcquireDirect3D12BufferResource faz a transição da propriedade de um recurso de buffer de conteúdo direct3D 12 da plataforma para o aplicativo. Se seu aplicativo já tiver o controle do recurso, a aquisição ainda será considerada um sucesso.
Depois de confirmar um recurso para um HolographicFrame chamando IHolographicQuadLayerUpdateParametersInterop::CommitDirect3D12Resource, seu aplicativo deve considerar o controle desse recurso a ser renunciado ao sistema até que ele seja readquirido pelo aplicativo usando AcquireDirect3D12BufferResource. O sistema possui o buffer até que ele não seja mais necessário para apresentar a camada quad. Para determinar se o sistema abriu mão do controle do buffer, chame AcquireDirect3D12BufferResource ou AcquireDirect3D12BufferResourceWithTimeout. Se o buffer não puder ser adquirido quando o aplicativo estiver pronto para começar a renderizar uma nova atualização para a camada quad, você deverá criar um novo recurso e adicioná-lo à fila de buffers ou limitar o tamanho da fila aguardando que um buffer fique disponível.
Se o buffer não estiver pronto para ser adquirido quando esse método for chamado, a chamada de método falhará e retornará imediatamente o código de erro E_NOTREADY.
Seu aplicativo pode limitar o tamanho da fila chamando AcquireDirect3D12BufferResourceWithTimeout para aguardar até que um recurso fique disponível antes de enfileirar mais trabalho.
Sintaxe
HRESULT AcquireDirect3D12BufferResource(
ID3D12Resource *pResourceToAcquire,
ID3D12CommandQueue *pCommandQueue
);
Parâmetros
pResourceToAcquire
Tipo: ID3D12Resource*
O recurso Direct3D 12 a ser adquirido. O recurso estará no estado D3D12_RESOURCE_STATE_COMMON quando for adquirido.
pCommandQueue
Tipo: ID3D12CommandQueue*
A fila de comandos do Direct3D 12 a ser usada para fazer a transição do estado desse recurso ao adquiri-lo para seu aplicativo.
Valor retornado
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
| 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 |