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 :
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 .
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