Partager via

énumération IDDCX_ADAPTER_FLAGS (iddcx.h)

  • Article

IDDCX_ADAPTER_FLAGS spécifie les indicateurs de fonctionnalité booléenne pour un adaptateur d’affichage indirect.

Syntaxe

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
} ;

Constantes

 
IDDCX_ADAPTER_FLAGS_NONE
Valeur : 0
Indique qu’aucun indicateur n’est défini pour l’adaptateur.
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE
Valeur : 0x1
Le modèle d’affichage indirect prend automatiquement en charge les modes virtuels du système d’exploitation, ce qui permet au système d’exploitation d’effectuer en toute transparence les modifications de mode à l’aide de la mise à l’échelle du Gestionnaire de fenêtres windows (DWM) de bureau par image sans modification du mode d’affichage. Un inconvénient se produit lorsqu’un mode bureau plus petit est utilisé par l’utilisateur : l’image de bureau fournie au pilote est supérieure à la taille du bureau, ce qui permet d’encoder et de transmettre la bande passante.

Cette valeur d’énumération indique au système d’exploitation d’utiliser la plus petite taille possible de surface de bureau lorsque le mode de bureau est modifié. Une solution qui a une charge de traitement importante ou une bande passante de transmission limitée utilise généralement cet indicateur pour réduire la taille de l’image de bureau afin de traiter autant que possible.

La définition de cet indicateur entraîne une modification du mode chaque fois que la résolution de bureau est modifiée.
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS
Valeur : 0x2
Cet indicateur a été déconseillé depuis IddCx v1.7. Les pilotes peuvent toujours définir cet indicateur pour IddCx 1.7 et versions ultérieures, mais ils n’auront aucun effet. Si un pilote est conçu pour s’exécuter sur le pré-IddCx 1.7 et définit cet indicateur, ce pilote doit avoir la logique pour traiter les déplacements ; sinon, les utilisateurs voient des problèmes visuels lors de l’exécution sur des systèmes pré-IddCx 1.7.

Indique si le pilote peut utiliser les régions de déplacement fournies par le système d’exploitation en plus des rects sales lors de l’encodage de l’image. Le pilote ne doit définir cette valeur que sur TRUE s’il utilise les régions de déplacement, car le système d’exploitation entraîne un coût lors de la génération de ces ressources supplémentaires. Si le pilote définit cette valeur sur FALSE, le système d’exploitation convertit toutes les régions de déplacement en rects sales.
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER
Valeur : 0x4
Indique si le pilote est un pilote de session à distance prenant en charge les moniteurs de session à distance, plutôt que les moniteurs de session console. Un pilote de session à distance ne peut pas prendre en charge les moniteurs de session de console, et un pilote de session de console ne peut pas prendre en charge les moniteurs de session à distance. Prise en charge à partir de IddCx version 1.4.
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS
Valeur : 0x8
Indique que le pilote préfère utiliser la mémoire contiguë physiquement pour les mémoires tampons de chaîne d’échange, ce qui permet au pilote d’analyser directement les mémoires tampons sans avoir besoin d’une copie intermédiaire. Prise en charge à partir de IddCx version 1.6.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION
Valeur : 0x10
Indique que le pilote souhaite recevoir toutes les modifications de position du curseur ; autrement dit, il souhaite recevoir l’entrée de la souris injectée dans la session distante du client distant et les déplacements procéduraux provoqués par un appel d’API à partir d’une application ou du système d’exploitation sur le serveur.

Cet indicateur n’est valide qu’en cas de combinaison avec IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER. IddCxAdapterInitAsync échoue si IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION est défini sans IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER.

Prise en charge à partir de IddCx version 1.7.
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS
Valeur : 0x20
Un pilote qui définit cet indicateur demande au système d’exploitation de suivre les régions sales des mises à jour de bureau plus précisément. Ce suivi plus précis a une petite surcharge d’utilisation du processeur afin que les pilotes ne doivent définir cet indicateur que si les petites régions sales sont bénéfiques pour le pilote.

Prise en charge à partir de IddCx version 1.8.
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16
Indique que le pilote peut traiter les surfaces de virgule flottante à demi-précision IEEE (FP16). Un pilote doit définir IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 même pour les adaptateurs qui ne prennent pas en charge HDR ou SDR WCG. Le système d’exploitation envoie des surfaces ET modes HDR ou SDR WC au pilote lorsque la combinaison appropriée de moniteur, de fonctionnalités cibles, de paramètres d’O et ainsi de suite est en place. Par conséquent, un pilote qui définit IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 doit également prendre en charge les fonctions IddCx version 1.10 qui permettent cela. Un pilote qui prend en charge HDR10 doit être capable de :

* Réception et traitement des surfaces de format FP16 dans une chaîne d’échange.
* Application du niveau blanc SDR indiqué aux curseurs de la souris.

Les pilotes de console doivent également :

* Utilisez la nouvelle transformation de couleur de matrice 3x4.
* Acceptez et utilisez les métadonnées HDR.

Les pilotes distants doivent également :

* Fournissez des données de colorimétrie et un niveau blanc SDR si nécessaire.

Prise en charge à partir de IddCx version 1.10. Voir les remarques.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE
Valeur : 0x80
Seuls les pilotes distants peuvent définir cet indicateur.

Les pilotes distants peuvent utiliser IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE pour leur permettre de spécifier des modes cibles qui ne font pas partie d’un descripteur de moniteur. Normalement, le système d’exploitation choisit un mode en fonction de celui-ci dans la liste du mode moniteur et du mode cible, signalé via EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION ou EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES si aucun descripteur n’est disponible et la liste du mode cible. Les scénarios distants peuvent nécessiter des modes qui ne se trouvent pas dans le descripteur. Au lieu de cela, le pilote peut utiliser des modes cibles pour les décrire et indiquer au système d’exploitation qu’il ne doit pas être vérifié par rapport aux modes de surveillance.

Lorsqu’un pilote distant définit cet indicateur, il indique que chaque mode cible signalé dans les appels à EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 et IddCxMonitorUpdateModes2 est garanti être compatible avec le moniteur actuellement connecté. Le système d’exploitation n’appellera alors pas EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 ou EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES.

Prise en charge à partir de IddCx version 1.10. Voir les remarques.

Remarques

Pour déterminer si le système d’exploitation accepte le paramètre des pilotes IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 ou IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE, le pilote doit utiliser la macro IDD_IS_FUNCTION_AVAILABLE pour vérifier la présence de l’une des DDIS de la version 1.10 ; par exemple IDD_IS_FUNCTION_AVAILABLE(IddCxSwapChainReleaseAndAcquireBuffer2). Cette macro prend la valeur TRUE sur un système d’exploitation pris en charge v1.10 et false dans le cas contraire. Pour plus d’informations , consultez mises à jour pour IddCx versions 1.10 et ultérieures.

Exigences

Exigence Valeur
d’en-tête iddcx.h

Voir aussi

IDDCX_ADAPTER_CAPS

IddCxAdapterInitAsync