Partager via


Inscription des informations matérielles

Pour afficher des informations utiles à l’utilisateur et pour obtenir de l’aide sur le débogage, un pilote de miniport d’affichage doit définir certaines informations matérielles dans le registre. Un pilote miniport d’affichage doit définir un type de puce, un type de convertisseur numérique-analogique (DAC), une taille de mémoire (de l’adaptateur) et une chaîne pour identifier l’adaptateur. Ces informations sont affichées par l’application Afficher dans Panneau de configuration. En règle générale, le pilote définit ces informations dans sa fonction DxgkDdiAddDevice .

Pour définir ces informations, le pilote :

  1. Appelle la fonction IoOpenDeviceRegistryKey pour ouvrir et obtenir un handle pour une clé logicielle afin de stocker des informations spécifiques au pilote. Dans cet appel, le pilote spécifie l’indicateur PLUGPLAY_REGKEY_DRIVER dans le paramètre DevInstKeyType et la valeur KEY_SET_VALUE, KEY_WRITE ou KEY_ALL_ACCESS dans le paramètre DesiredAccess .

  2. Appelle la fonction ZwSetValueKey plusieurs fois pour définir chaque type d’informations matérielles. Dans chaque appel, le pilote spécifie, dans le paramètre KeyHandle , le handle de clé logicielle obtenu à partir de IoOpenDeviceRegistryKey.

    Le tableau suivant décrit les informations que le pilote doit inscrire et fournit des détails pour les paramètres ValueName et Data de ZwSetValueKey :

    Informations relatives à l’entrée Paramètre ValueName Paramètre de données

    Type de puce

    HardwareInformation.ChipType

    Chaîne terminée par null qui contient le nom de la puce

    Type de DAC

    HardwareInformation.DacType

    Chaîne terminée par null qui contient le nom ou l’identificateur de la DAC (ID)

    Taille de la mémoire

    HardwareInformation.MemorySize

    ULONG qui contient, en mégaoctets, la quantité de mémoire vidéo sur l’adaptateur

    ID de l’adaptateur

    HardwareInformation.AdapterString

    Chaîne terminée par null qui contient le nom de l’adaptateur

    BIOS

    HardwareInformation.BiosString

    Chaîne terminée par null qui contient des informations sur le BIOS