EVT_IDD_CX_ADAPTER_COMMIT_MODES2 funzione di callback (iddcx.h)

Articolo
02/07/2025

Il sistema operativo chiama EVT_IDD_CX_ADAPTER_COMMIT_MODES2 per informare il driver di una modifica della modalità per i monitoraggi sulla scheda.

Sintassi

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

NTSTATUS EvtIddCxAdapterCommitModes2(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES2 *pInArgs
)
{...}

Parametri

AdapterObject

[in] Oggetto adattatore generato dal sistema operativo dell'adattatore sottoposto a query. Questo handle di oggetto IDDCX_ADAPTER è stato restituito in una chiamata precedente a IddCxAdapterInitAsync.

pInArgs

[in] Puntatore a una struttura IDARG_IN_COMMITMODES2 che contiene argomenti utilizzati da EVT_IDD_CX_ADAPTER_COMMIT_MODES2.

Valore restituito

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 restituisce un valore di NTSTATUS. Se l'operazione ha esito positivo, restituisce STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS(status) è uguale a TRUE. In caso contrario, restituisce un codice di errore NTSTATUS appropriato.

Osservazioni

Quando viene eseguito il commit delle modalità per i monitor, i driver IddCx versione 1.10 che supportano HDR o WCG vengono chiamati tramite questa funzione e viene indicato lo spazio dei colori e i bit per ogni componente da usare nella connessione di monitoraggio fisico. Questi valori sono basati sulle funzionalità di destinazione e sui parametri della modalità segnalati in precedenza dal driver. Segnalazione del supporto dell'adattatore per il FP16, ma non l'esposizione di questa funzione è un errore.

Lo spazio colore specificato in una modalità di commit non specifica il formato di superficie utilizzato per ogni superficie in una porta di scambio. La superficie fornita in IDDCX_METADATA2 deve comunque essere eseguita una query.

Il sistema operativo fornisce sempre il IDDCX_PATH2 per ogni monitor connesso anche se tale monitoraggio non è attivo e indica quali percorsi sono stati modificati. Se un percorso è contrassegnato come inattivo, l'intera pipeline di visualizzazione per tale percorso verrà spenta e non verrà inviato alcun segnale al monitor.

Quando viene eseguito il commit di un nuovo percorso, il driver deve programmare la pipeline di visualizzazione per visualizzare un'immagine nera fino a quando il primo fotogramma non è pronto per essere visualizzato. A tale scopo, la visibilità WDDM deve essere disattivata fino a quando il primo fotogramma non è pronto per essere visualizzato, quindi la visibilità deve essere attivata.

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