Método IHolographicQuadLayerInterop::AcquireDirect3D12BufferResource (windows.graphics.holographic.interop.h)

  • Artículo

El método AcquireDirect3D12BufferResource realiza la transición de la propiedad de un recurso de búfer de contenido de Direct3D 12 desde la plataforma a la aplicación. Si la aplicación ya posee el control del recurso, la adquisición todavía se considera correcta.

Después de confirmar un recurso en un HolographicFrame mediante una llamada a IHolographicQuadLayerUpdateParametersInterop::CommitDirect3D12Resource, la aplicación debe considerar el control de ese recurso que se va a renunciar al sistema hasta que la aplicación lo vuelva a adquirir mediante AcquireDirect3D12BufferResource. El sistema posee el búfer hasta que ya no es necesario para presentar la capa cuádruple. Para determinar si el sistema ha renunciado al control del búfer, llame a AcquireDirect3D12BufferResource o AcquireDirect3D12BufferResourceWithTimeout. Si el búfer no se puede adquirir en el momento en que la aplicación está lista para empezar a representar una nueva actualización para la capa cuádruple, debe crear un nuevo recurso y agregarlo a la cola del búfer o limitar el tamaño de la cola esperando a que un búfer esté disponible.

Si el búfer no está listo para adquirirse cuando se llama a este método, se produce un error en la llamada al método y devuelve inmediatamente el código de error E_NOTREADY.

La aplicación puede limitar el tamaño de la cola llamando a AcquireDirect3D12BufferResourceWithTimeout para esperar hasta que un recurso esté disponible antes de poner más en cola.

Sintaxis

HRESULT AcquireDirect3D12BufferResource(
  ID3D12Resource     *pResourceToAcquire,
  ID3D12CommandQueue *pCommandQueue
);

Parámetros

pResourceToAcquire

Tipo: ID3D12Resource*

Recurso de Direct3D 12 que se va a adquirir. El recurso estará en el estado D3D12_RESOURCE_STATE_COMMON cuando se adquiera.

pCommandQueue

Tipo: ID3D12CommandQueue*

La cola de comandos de Direct3D 12 que se va a usar para realizar la transición del estado de este recurso al adquirirlo para la aplicación.

Valor devuelto

S_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT que indica el motivo del error. Consulte también Códigos de error COM (UI, Audio, DirectX, Codec).

Requisitos

   
Cliente mínimo compatible Windows 10, versión 2004 (10.0; Compilación 19041)
Servidor mínimo compatible Windows Server, versión 2004 (10.0; Compilación 19041)
Encabezado windows.graphics.holographic.interop.h

Consulte también

AcquireDirect3D12BufferResourceWithTimeout