Funzione IddCxSwapChainReleaseAndAcquireBuffer2 (iddcx.h)

Articolo
02/07/2025

Un driver di visualizzazione indiretto chiama IddCxSwapChainReleaseAndAcquireBuffer2 per rilasciare il buffer corrente nella catena di scambio e acquisirne uno nuovo. Un driver che supporta adattatori HDR deve usare iddCxSwapChainReleaseAndAcquireBuffer2 anziché IddCxSwapChainReleaseAndAcquireBuffer e IddCxSwapChainReleaseAndAcquireSystemBuffer.

Sintassi

HRESULT IddCxSwapChainReleaseAndAcquireBuffer2(
  IDDCX_SWAPCHAIN                    SwapChainObject,
  IDARG_IN_RELEASEANDACQUIREBUFFER2  *pInArgs,
  IDARG_OUT_RELEASEANDACQUIREBUFFER2 *pOutArgs
);

Parametri

SwapChainObject

[in] Oggetto della catena di scambio passato in precedenza dal sistema operativo al driver in una chiamata EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN.

pInArgs

[in] Puntatore a una struttura IDARG_IN_RELEASEANDACQUIREBUFFER2 contenente gli argomenti di input per la funzione.

pOutArgs

[out] Puntatore a una struttura IDARG_OUT_RELEASEANDACQUIREBUFFER2 in cui vengono restituiti gli argomenti di output della funzione.

Valore restituito

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

Osservazioni

Anche lo spazio colore della superficie passata nello struct IDDCX_METADATA2 viene passato al driver. Ciò è dovuto al fatto che può cambiare per ogni fotogramma e non corrispondere allo spazio dei colori specificato quando è stato eseguito il commit di una modalità.

Analogamente, il formato pixel della superficie fornita può cambiare in base al fotogramma. Ad esempio, se viene eseguito il commit di una modalità HDR in un percorso, ciò non garantisce che ogni superficie sarà una superficie FP16.

Il livello bianco per il contenuto SDR è incluso anche per essere applicato ai cursori del mouse.

Se IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA è impostato in IDDCX_METADATA2::ValidFlags, IDDCX_METADATA2::Hdr10FrameMetaData contiene dati validi. Questi metadati possono essere uno dei tre tipi seguenti:

Nuovi dati che il driver deve usare.
Indicazione che devono essere usati i metadati predefiniti inviati in precedenza al driver in una chiamata a EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA.
Indicazione che i metadati inviati in precedenza devono essere usati di nuovo. Quando il tipo è predefinito o invariato, i valori in IDDCX_HDR10_FRAME_METADATA::NewMetaData non sono validi.

IddCxSwapChainReleaseAndAcquireBuffer2 sostituisce anche IddCxSwapChainReleaseAndAcquireSystemBuffer. Un driver che avrebbe chiamato IddCxSwapChainReleaseAndAcquireSystemBuffer può impostare IDARG_IN_RELEASEANDACQUIREBUFFER2::AcquireSystemMemoryBuffer per indicare che è necessario IDDCX_METADATA2::SystemBufferInfo compilato.

I driver versione 1.10 che non segnalano supporto FP16 possono comunque chiamare questa funzione se disponibile nel sistema operativo.

Per altre informazioni sul supporto HDR, vedere aggiornamenti iddCx versione 1.10.

Metadati HDR remoti

Il sistema operativo non passerà i metadati HDR ai driver remoti perché i metadati HDR nel sistema client devono essere usati, non generati dal server. Per i driver remoti IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA non verranno mai impostati.