Metodo IHolographicQuadLayerInterop::AcquireDirect3D12BufferResource (windows.graphics.holographic.interop.h)

Articolo
03/08/2023

Il metodo AcquireDirect3D12BufferResource passa la proprietà di una risorsa buffer di contenuto Direct3D 12 dalla piattaforma all'applicazione. Se l'applicazione possiede già il controllo della risorsa, l'acquisizione è ancora considerata un successo.

Dopo aver eseguito il commit di una risorsa in un HolographicFrame chiamando IHolographicQuadLayerUpdateParametersInterop::CommitDirect3D12Resource, l'applicazione deve considerare il controllo di tale risorsa da rimettere nel sistema fino a quando non viene riacquisito dall'applicazione usando AcquireDirect3D12BufferResource. Il sistema possiede il buffer finché non è più necessario per presentare il livello quad. Per determinare se il sistema ha riabilitare il controllo del buffer, chiamare AcquireDirect3D12BufferResource o AcquireDirect3D12BufferResourceWithTimeout. Se il buffer non può essere acquisito dal momento in cui l'applicazione è pronta per avviare il rendering di un nuovo aggiornamento per il livello quad, è necessario creare una nuova risorsa e aggiungerla alla coda del buffer oppure limitare le dimensioni della coda aspettando che un buffer diventi disponibile.

Se il buffer non è pronto per essere acquisito quando questo metodo viene chiamato, la chiamata al metodo ha esito negativo e restituisce immediatamente il codice di errore E_NOTREADY.

L'applicazione può limitare le dimensioni della coda chiamando AcquireDirect3D12BufferResourceWithTimeout per attendere fino a quando una risorsa non diventa disponibile prima di accodare più lavoro.

Sintassi

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

Parametri

pResourceToAcquire

Tipo: ID3D12Resource*

Risorsa Direct3D 12 da acquisire. La risorsa sarà nello stato D3D12_RESOURCE_STATE_COMMON quando viene acquisita.

pCommandQueue

Tipo: ID3D12CommandQueue*

Coda di comandi Direct3D 12 da usare per la transizione dello stato di questa risorsa durante l'acquisizione per l'applicazione.

Valore restituito

S_OK se ha esito positivo, in caso contrario, restituisce un codice di errore HRESULT che indica il motivo dell'errore. Vedere anche codici di errore COM (interfaccia utente, Audio, DirectX, Codec).

Requisiti


Client minimo supportato	Windows 10 versione 2004 (10.0; Build 19041)
Server minimo supportato	Windows Server, versione 2004 (10.0; Build 19041)
Intestazione	windows.graphics.holographic.interop.h

Vedi anche

AcquireDirect3D12BufferResourceWithTimeout

Condividi tramite