EVT_IDD_CX_ADAPTER_COMMIT_MODES2 fonction de rappel (iddcx.h)

Article
02/07/2025

Le système d’exploitation appelle EVT_IDD_CX_ADAPTER_COMMIT_MODES2 pour informer le pilote d’une modification de mode pour les moniteurs sur l’adaptateur.

Syntaxe

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

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

Paramètres

AdapterObject

[in] Objet d’adaptateur généré par le système d’exploitation de l’adaptateur interrogé. Ce handle d’objet IDDCX_ADAPTER a été retourné dans un appel précédent à IddCxAdapterInitAsync.

pInArgs

[in] Pointeur vers une structure IDARG_IN_COMMITMODES2 qui contient des arguments utilisés par EVT_IDD_CX_ADAPTER_COMMIT_MODES2.

Valeur de retour

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 retourne une valeur de NTSTATUS. Si l’opération réussit, elle retourne STATUS_SUCCESS ou une autre valeur d’état pour laquelle NT_SUCCESS(status) a la valeur TRUE. Sinon, elle retourne un code d’erreur NTSTATUS approprié.

Remarques

Lorsque les modes sont validés pour les moniteurs, les pilotes IddCx version 1.10 qui prennent en charge HDR ou WCG sont appelés via cette fonction et indiquent à l’espace de couleur et aux bits par composant à utiliser sur la connexion du moniteur physique. Ces valeurs sont basées sur les fonctionnalités cibles et les paramètres de mode précédemment signalés par le pilote. La prise en charge de l’adaptateur pour FP16, mais pas l’exposition de cette fonction est une erreur.

L’espace de couleur spécifié en mode validé ne spécifie pas le format de surface utilisé pour chaque surface dans une chaîne d’échange. La surface fournie dans IDDCX_METADATA2 doit toujours être interrogée.

Le système d’exploitation fournit toujours les IDDCX_PATH2 pour chaque moniteur connecté, même si ce moniteur n’est pas actif et indique les chemins d’accès qui ont changé. Si un chemin d’accès est marqué inactif, l’ensemble du pipeline d’affichage de ce chemin sera éteint et aucun signal n’est envoyé au moniteur.

Lorsqu’un nouveau chemin d’accès est validé, le pilote doit programmer le pipeline d’affichage pour afficher une image noire jusqu’à ce que le premier frame soit prêt à être affiché. Pour ce faire, la visibilité WDDM doit être désactivée jusqu’à ce que la première image soit prête à être affichée, alors la visibilité doit être activée.

Pour plus d’informations sur la prise en charge HDR, consultez mises à jour IddCx version 1.10.