Partager via

énumération DEVICE_REGISTRY_PROPERTY (wdm.h)

L’énumération DEVICE_REGISTRY_PROPERTY identifie les propriétés d’appareil stockées dans le Registre.

Syntaxe

typedef enum {
  DevicePropertyDeviceDescription,
  DevicePropertyHardwareID,
  DevicePropertyCompatibleIDs,
  DevicePropertyBootConfiguration,
  DevicePropertyBootConfigurationTranslated,
  DevicePropertyClassName,
  DevicePropertyClassGuid,
  DevicePropertyDriverKeyName,
  DevicePropertyManufacturer,
  DevicePropertyFriendlyName,
  DevicePropertyLocationInformation,
  DevicePropertyPhysicalDeviceObjectName,
  DevicePropertyBusTypeGuid,
  DevicePropertyLegacyBusType,
  DevicePropertyBusNumber,
  DevicePropertyEnumeratorName,
  DevicePropertyAddress,
  DevicePropertyUINumber,
  DevicePropertyInstallState,
  DevicePropertyRemovalPolicy,
  DevicePropertyResourceRequirements,
  DevicePropertyAllocatedResources,
  DevicePropertyContainerID
} DEVICE_REGISTRY_PROPERTY;

Constantes

 
DevicePropertyDeviceDescription
Chaîne décrivant l’appareil, par exemple « Souris de port Microsoft PS/2 », généralement définie par le fabricant. Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyHardwareID
ID matériels fournis par l’appareil qui identifie l’appareil. Le type de propriété est une valeur REG_MULTI_SZ.
DevicePropertyCompatibleIDs
ID compatibles signalés par l’appareil. Le type de propriété est une valeur REG_MULTI_SZ.
DevicePropertyBootConfiguration
Ressources matérielles affectées à l’appareil par le microprogramme, sous forme brute. Le type de propriété est une structure CM_RESOURCE_LIST .
DevicePropertyBootConfigurationTranslated
Ressources matérielles affectées à l’appareil par le microprogramme, sous forme traduite. Le type de propriété est une structure CM_RESOURCE_LIST .
DevicePropertyClassName
Nom de la classe d’installation de l’appareil, au format texte. Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyClassGuid
GUID pour la classe d’installation de l’appareil. Le type de propriété est un tableau null de WCHAR.

GUID dans un format de chaîne comme suit, où chaque « c » représente un caractère hexadécimal : {cccccccc-cccc-cccc-cccc-cccc-cccccccccc}
DevicePropertyDriverKeyName
Nom de la clé de Registre spécifique au pilote. Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyManufacturer
Chaîne identifiant le fabricant de l’appareil. Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyFriendlyName
Chaîne qui peut être utilisée pour distinguer deux appareils similaires, généralement définis par le programme d’installation de classe. Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyLocationInformation
Informations sur l’emplacement de l’appareil sur le bus ; l’interprétation de ces informations est spécifique à l’autobus. Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyPhysicalDeviceObjectName
Nom de l’objet PDO pour cet appareil. Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyBusTypeGuid
GUID du bus auquel l’appareil est connecté. Les GUID de type bus définis par le système sont répertoriés dans le fichier d’en-tête Wdmguid.h . Le type de propriété est un GUID, qui est une structure de 16 octets qui contient le GUID sous forme binaire.
DevicePropertyLegacyBusType
Demande le type de bus, tel que PCIBus ou PCMCIABus. Le type de propriété est une valeur d’énumération INTERFACE_TYPE .
DevicePropertyBusNumber
Numéro de bus hérité du bus à lequel l’appareil est connecté. Le type de propriété est ULONG.
DevicePropertyEnumeratorName
Nom de l’énumérateur pour l’appareil, tel que « PCI » ou « root ». Le type de propriété est une chaîne WCHAR terminée par NULL.
DevicePropertyAddress
Adresse de l’appareil sur le bus. Le type de propriété est ULONG.

L’interprétation de cette adresse est spécifique au bus. L’appelant de cette routine doit appeler à nouveau la routine pour demander DevicePropertyBusTypeGuid, ou éventuellement devicePropertyLegacyBusType, afin qu’elle puisse interpréter l’adresse. Une valeur d’adresse de 0xFFFFFFFF indique que le pilote de bus sous-jacent n’a pas fourni d’adresse de bus pour l’appareil.

Consultez les remarques pour obtenir des informations supplémentaires sur le pilote de bus.
DevicePropertyUINumber
Numéro associé à l’appareil qui peut être affiché dans l’interface utilisateur. Le type de propriété est une valeur ULONG.

Ce nombre est généralement un numéro d’emplacement perçu par l’utilisateur, tel qu’un nombre imprimé à côté de l’emplacement sur la carte, ou un autre nombre qui facilite la localisation de l’appareil physique pour l’utilisateur. Si l’appareil se trouve sur un bus sans convention de numéro d’interface utilisateur ou si le pilote de bus de l’appareil ne peut pas déterminer le numéro d’interface utilisateur, cette valeur est 0xFFFFFFFF.
DevicePropertyInstallState
État d’installation de l’appareil. Le type de propriété est une valeur d’énumération DEVICE_INSTALL_STATE .
DevicePropertyRemovalPolicy
Stratégie de suppression actuelle de l’appareil. Le système d’exploitation utilise cette valeur comme indicateur pour déterminer comment l’appareil est normalement supprimé. Le type de propriété est une valeur d’énumération DEVICE_REMOVAL_POLICY .
DevicePropertyResourceRequirements
Configuration requise pour les ressources de l’appareil. Le type de propriété est une structure IO_RESOURCE_REQUIREMENTS_LIST .
DevicePropertyAllocatedResources
Ressources allouées par l’appareil. Le type de propriété est une structure CM_RESOURCE_LIST .
DevicePropertyContainerID
ID de conteneur de l’appareil. Le type de propriété est une chaîne WCHAR terminée par NULL.

Remarques

Pour la valeur DevicePropertyAddress , la liste suivante décrit les informations que certains pilotes de bus stockent pour leurs appareils enfants :

Autobus Descriptif
1394 Ne fournit pas d’adresse, car les adresses sont volatiles. La valeur par défaut est 0xFFFFFFFF.
EISA Numéro d’emplacement (0-F).
IDE Pour un appareil IDE, l’adresse contient l’ID cible et le numéro d’unité logique. Pour un canal IDE, l’adresse est zéro ou une (0 = canal principal et 1 = canal secondaire).
ISApnp Ne fournit pas d’adresse. La valeur par défaut est 0xFFFFFFFF.
Carte PC (PCMCIA) Numéro de socket (généralement 0x00 ou 0x40).
PCI Numéro d’appareil dans le mot élevé et numéro de fonction dans le mot bas.
SCSI ID cible.
USB Numéro de port.

Spécifications

Besoin Valeur
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)

Voir aussi

IoGetDeviceProperty

  • Last updated on