Funzione IddCxSwapChainReleaseAndAcquireSystemBuffer (iddcx.h)

Articolo
02/26/2024

IddCxSwapChainReleaseAndAcquireSystemBuffer rilascia e acquisisce buffer dalla swapchain.

Sintassi

HRESULT IddCxSwapChainReleaseAndAcquireSystemBuffer(
  [in]  IDDCX_SWAPCHAIN                         SwapChainObject,
  [out] IDARG_OUT_RELEASEANDACQUIRESYSTEMBUFFER *pOutArgs
);

Parametri

[in] SwapChainObject

Oggetto IDDCX_SWAPCHAIN utilizzato per eseguire query sull'indirizzo fisico della superficie attualmente acquisita.

[out] pOutArgs

Puntatore a una struttura IDARG_OUT_RELEASEANDACQUIRESYSTEMBUFFER in cui vengono restituite le informazioni risultanti dalla versione e l'operazione di acquisizione.

Valore restituito

IddCxSwapChainReleaseAndAcquireSystemBuffer restituisce S_OK in caso di esito positivo; in caso contrario restituisce un codice di errore appropriato.

Commenti

Oltre a rilasciare e acquisire buffer dalla swapchain, IddCxSwapChainReleaseAndAcquireSystemBuffer annulla anche il mapping e sblocca il buffer rilasciato durante il mapping e il blocco del buffer acquisito. Per questo motivo, non è valido chiamare IddCxSwapChainReleaseAndAcquireBuffer successivamente a chiamare questo metodo. La struttura IDDCX_SYSTEM_BUFFER_INFO a cui punta pBufferInfo è compilata con informazioni valide solo su una versione riuscita e acquisire come indicato da un valore restituito di S_OK.