Condividi tramite

enumerazione IDDCX_ADAPTER_FLAGS (iddcx.h)

  • Articolo

IDDCX_ADAPTER_FLAGS specifica i flag di funzionalità booleani per una scheda di visualizzazione indiretta.

Sintassi

typedef enum IDDCX_ADAPTER_FLAGS {
  IDDCX_ADAPTER_FLAGS_NONE = 0,
  IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE = 0x1,
  IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS = 0x2,
  IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER = 0x4,
  IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS = 0x8,
  IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION = 0x10,
  IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS = 0x20,
  IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 = 0x40,
  IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE = 0x80
} ;

Costanti

 
IDDCX_ADAPTER_FLAGS_NONE
Valore: 0
Indica che non sono presenti flag impostati per l'adapter.
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE
Valore: 0x1
Il modello di visualizzazione indiretto supporta automaticamente le modalità virtuali del sistema operativo, consentendo al sistema operativo di eseguire facilmente le modifiche della modalità usando Gestione finestre desktop (DWM) in base a un frame senza modificare la modalità di visualizzazione. Uno svantaggio si verifica quando una modalità desktop più piccola viene usata dall'utente: l'immagine desktop fornita al driver è maggiore delle dimensioni del desktop, quindi la codifica e la trasmissione della larghezza di banda.

Questo valore di enumerazione indica al sistema operativo di usare le dimensioni più piccole possibili della superficie desktop quando viene modificata la modalità desktop. Una soluzione con un sovraccarico di elaborazione elevato o una larghezza di banda di trasmissione limitata usa in genere questo flag per ridurre le dimensioni dell'immagine desktop per elaborare il più possibile.

L'impostazione di questo flag comporta una modifica della modalità ogni volta che viene modificata la risoluzione desktop.
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS
Valore: 0x2
Questo flag è stato deprecato a partire da IddCx v1.7. I driver possono comunque impostare questo flag per IddCx 1.7 e versioni successive, ma non avrà alcun effetto. Se un driver è progettato per l'esecuzione in pre-IddCx 1.7 e imposta questo flag, tale driver deve avere la logica per elaborare i movimenti; in caso contrario, gli utenti visualizzeranno problemi visivi durante l'esecuzione nei sistemi pre-IddCx 1.7.

Indica se il driver può usare le aree di spostamento fornite dal sistema operativo oltre alle recte sporche durante la codifica dell'immagine. Il driver deve impostare questo solo su TRUE se usa le aree di spostamento perché il sistema operativo comporta un costo durante la generazione di queste risorse aggiuntive. Se il driver imposta questo valore su FALSE, il sistema operativo converte tutte le aree di spostamento in recinti sporche.
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER
Valore: 0x4
Indica se il driver è un driver di sessione remoto che supporta i monitoraggi delle sessioni remote, anziché i monitoraggi delle sessioni console. Un driver di sessione remoto non può supportare i monitoraggi delle sessioni della console e un driver di sessione console non può supportare i monitoraggi delle sessioni remote. Supportato a partire da IddCx versione 1.4.
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS
Valore: 0x8
Indica che il driver preferisce la memoria fisicamente contigua da usare per i buffer della catena di scambio, consentendo al driver di analizzare direttamente i buffer senza la necessità di una copia intermedia. Supportato a partire da IddCx versione 1.6.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION
Valore: 0x10
Indica che il driver vuole ricevere tutte le modifiche alla posizione del cursore; ovvero, vuole ricevere sia l'input del mouse inserito nella sessione remota dal client remoto che gli spostamenti procedurali causati da una chiamata API da un'applicazione o dal sistema operativo nel server.

Questo flag è valido solo se combinato con IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER. IddCxAdapterInitAsync avrà esito negativo se IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION è impostato senza IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER.

Supportato a partire da IddCx versione 1.7.
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS
Valore: 0x20
Un driver che imposta questo flag richiede al sistema operativo di tenere traccia delle aree sporche degli aggiornamenti desktop in modo più accurato. Questo rilevamento più accurato ha un piccolo sovraccarico di utilizzo della CPU, quindi i driver devono impostare questo flag solo se le aree sporche più piccole sono utili per il driver.

Supportato a partire da IddCx versione 1.8.
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16
Indica che il driver può elaborare superfici di swapchain a metà precisione IEEE (FP16). Un driver deve impostare IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 anche per le schede che non supportano HDR o WCG SDR. Il sistema operativo invia superfici e modalità HDR o WC SDR al driver quando la combinazione corretta di monitor, funzionalità di destinazione, impostazioni O e così via sono presenti. Pertanto, un driver che imposta IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 deve supportare anche le funzioni IddCx versione 1.10 che consentono di eseguire questa operazione. Un driver che supporta HDR10 deve essere in grado di:

* Ricezione ed elaborazione di superfici di formato FP16 all'interno di una swapchain.
* Applicazione del livello bianco SDR indicato ai cursori del mouse.

I driver della console devono anche:

* Usare la nuova trasformazione del colore matrice 3x4.
* Accettare e usare metadati HDR.

I driver remoti devono anche:

* Specificare i colorimetria e il livello di bianco SDR quando necessario.

Supportato a partire da IddCx versione 1.10. Vedere la sezione Osservazioni.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE
Valore: 0x80
Solo i driver remoti possono impostare questo flag.

I driver remoti possono usare IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE per consentire loro di specificare le modalità di destinazione che non fanno parte di un descrittore di monitoraggio. In genere il sistema operativo sceglie una modalità in base alla modalità di monitoraggio e di destinazione, segnalata tramite EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION o EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES se non è disponibile alcun descrittore e l'elenco di modalità di destinazione. Gli scenari remoti possono richiedere modalità che non si trovano nel descrittore. Il driver può invece usare le modalità di destinazione per descriverle e indicare al sistema operativo che non devono essere controllate in modalità di monitoraggio.

Quando un driver remoto imposta questo flag, indica che ogni modalità di destinazione segnalata nelle chiamate a EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 e IddCxMonitorUpdateModes2 è garantita la compatibilità con il monitoraggio attualmente connesso. Il sistema operativo non chiamerà quindi EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 o EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES.

Supportato a partire da IddCx versione 1.10. Vedere la sezione Osservazioni.

Commenti

Per determinare se il sistema operativo accetta l'impostazione dei driver IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 oIDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE, il driver deve usare la macro IDD_IS_FUNCTION_AVAILABLE per verificare la presenza di una delle versioni 1.10 DDI; ad esempio IDD_IS_FUNCTION_AVAILABLE(IddCxSwapChainReleaseAndAcquireBuffer2). Questa macro restituisce TRUE in un sistema operativo supportato da v1.10 e false in caso contrario. Per altre informazioni, vedere Aggiornamenti per IddCx versione 1.10 e versioni successive.

Requisiti

Requisito Valore
Intestazione iddcx.h

Vedi anche

IDDCX_ADAPTER_CAPS

IddCxAdapterInitAsync