Compartir a través de

Método IHolographicCameraInterop::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 back de Direct3D 12 de la plataforma a la aplicación. Si la aplicación ya posee el control del recurso, la adquisición todavía se considera un éxito.

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 pertenece al sistema hasta que la aplicación vuelva a adquirir el recurso mediante este método. El sistema posee el búfer hasta que el marco en el que se confirmó el búfer pasa por la cola de presentación. 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 un nuevo HolographicFrame, 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 AcquireDirect3D12BufferResource , se producirá un error en la llamada al método y se devolverá 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 en cola más trabajo.

Sintaxis

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

Parámetros

pResourceToAcquire

Tipo: ID3D12Resource*

Recurso de Direct3D 12 que se va a adquirir.

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. El recurso estará en el estado D3D12_RESOURCE_STATE_COMMON cuando se adquiera. Es posible que el comando de transición de recursos no esté en cola si el recurso ya está en estado común cuando se adquiere.

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