Funzione IddCxSwapChainReleaseAndAcquireBuffer2 (iddcx.h)

Articolo
02/29/2024

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

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 al successo; in caso contrario, restituisce un codice di errore appropriato.

Commenti

Lo spazio del colore della superficie passata nello struct IDDCX_METADATA2 viene passato anche al driver. Questo perché può cambiare in base a 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 a fotogrammi. Ad esempio, se si esegue il commit di una modalità HDR in un percorso, questo non garantisce che ogni superficie sarà una superficie FP16.

Il livello di 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:

Nuovi dati che il driver deve usare.
Indicazione che i metadati predefiniti inviati in precedenza al driver in una chiamata a EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA devono essere usati.
Indicazione che tutti 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 le esigenze IDDCX_METADATA2 ::SystemBufferInfo compilato.

La versione 1.10 dei driver che non segnalano il supporto FP16 può comunque chiamare questa funzione se è disponibile nel sistema operativo.

Per altre informazioni sul supporto HDR, vedere Aggiornamenti di IddCx versione 1.10.

Metadati HDR remoti

Il sistema operativo non passerà 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 verrà mai impostato.