DEVICE_REGISTRY_PROPERTY Enumeration (wdm.h)

Die DEVICE_REGISTRY_PROPERTY Enumeration identifiziert Geräteeigenschaften, die in der Registrierung gespeichert sind.

Syntax

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;

Konstanten

DevicePropertyDeviceDescription Zeichenfolge, die das Gerät beschreibt, z. B. "Microsoft PS/2 Port Mouse", normalerweise vom Hersteller definiert. Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyHardwareID Hardware-IDs vom Gerät bereitgestellt, das das Gerät identifiziert. Der Eigenschaftstyp ist ein REG_MULTI_SZ Wert.
DevicePropertyCompatibleIDs kompatiblen IDs vom Gerät gemeldet. Der Eigenschaftstyp ist ein REG_MULTI_SZ Wert.
DevicePropertyBootConfiguration Hardwareressourcen, die dem Gerät von der Firmware in unformatierter Form zugewiesen wurden. Der Eigenschaftentyp ist eine CM_RESOURCE_LIST Struktur.
DevicePropertyBootConfigurationTranslated Die Hardwareressourcen, die dem Gerät durch die Firmware zugewiesen wurden, in übersetzter Form. Der Eigenschaftentyp ist eine CM_RESOURCE_LIST Struktur.
DevicePropertyClassName Name der Setupklasse des Geräts im Textformat. Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyClassGuid GUID für die Setupklasse des Geräts. Der Eigenschaftentyp ist ein NULL-beendetes Array von WCHAR. Die GUID in einem Zeichenfolgenformat wie folgt, wobei jedes "c" ein hexadezimales Zeichen darstellt: {cccccccc-cccc-cccc-cc}
DevicePropertyDriverKeyName Name des treiberspezifischen Registrierungsschlüssels. Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyManufacturer Zeichenfolge, die den Hersteller des Geräts identifiziert. Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyFriendlyName Zeichenfolge, die verwendet werden kann, um zwischen zwei ähnlichen Geräten zu unterscheiden, die normalerweise vom Klasseninstallationsprogramm definiert werden. Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyLocationInformation Informationen über die Position des Geräts im Bus; die Auslegung dieser Informationen ist busspezifisch. Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyPhysicalDeviceObjectName Der Name des PDO für dieses Gerät. Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyBusTypeGuid GUID für den Bus, mit dem das Gerät verbunden ist. Die vom System definierten Bustyp-GUIDs werden in der Wdmguid.h Headerdatei aufgeführt. Der Eigenschaftentyp ist eine GUID, bei der es sich um eine 16-Byte-Struktur handelt, die die GUID in binärer Form enthält.
DevicePropertyLegacyBusType Fordert den Bustyp an, z. B. PCIBus oder PCMCIABus. Der Eigenschaftstyp ist ein INTERFACE_TYPE Enumerationswert.
DevicePropertyBusNumber Legacybusnummer des Busses, mit dem das Gerät verbunden ist. Der Eigenschaftentyp ist ein ULONG.
DevicePropertyEnumeratorName Name des Enumerators für das Gerät, z. B. "PCI" oder "root". Der Eigenschaftentyp ist eine MIT NULL beendete WCHAR-Zeichenfolge.
DevicePropertyAddress Adresse des Geräts im Bus. Der Eigenschaftentyp ist ein ULONG. Die Auslegung dieser Adresse ist busspezifisch. Der Aufrufer dieser Routine sollte die Routine erneut aufrufen, um die DevicePropertyBusTypeGuidoder möglicherweise den DevicePropertyLegacyBusTypeanzufordern, damit sie die Adresse interpretieren kann. Ein Adresswert von 0xFFFFFFFF gibt an, dass der zugrunde liegende Bustreiber keine Busadresse für das Gerät bereitgestellt hat. In der folgenden Liste werden die Informationen beschrieben, die bestimmte Bustreiber für ihre untergeordneten Geräte speichern:	Bus	Beschreibung		-----	-------------		1394	Gibt keine Adresse an, da die Adressen veränderlich sind. Der Standardwert ist 0xFFFFFFFF.		EISA	Steckplatznummer (0-F).		ALAND	Bei einem IDE-Gerät enthält die Adresse die Ziel-ID und LUN. Bei einem IDE-Kanal ist die Adresse null oder eins (0 = primärer Kanal und 1 = sekundärer Kanal).		ISApnp	Gibt keine Adresse an. Der Standardwert ist 0xFFFFFFFF.		PC-Karte (PCMCIA)	Die Socketnummer (in der Regel 0x00 oder 0x40).		PCI	Die Gerätenummer im hohen Wort und die Funktionsnummer im wortarmen Wort.		SCSI	Die Ziel-ID.		USB	Die Portnummer.
DevicePropertyUINumber Die dem Gerät zugeordnete Nummer, die auf der Benutzeroberfläche angezeigt werden kann. Der Eigenschaftstyp ist ein ULONG-Wert. Diese Nummer ist in der Regel eine vom Benutzer wahrgenommene Steckplatznummer, z. B. eine Nummer, die neben dem Steckplatz auf dem Board gedruckt wird, oder eine andere Nummer, die das Auffinden des physischen Geräts für den Benutzer erleichtert. Wenn sich das Gerät auf einem Bus befindet, der keine UI-Nummernkonvention aufweist oder der Bustreiber für das Gerät die UI-Nummer nicht ermitteln kann, ist dieser Wert 0xFFFFFFFF.
DevicePropertyInstallState Installationsstatus des Geräts. Der Eigenschaftstyp ist ein DEVICE_INSTALL_STATE Enumerationswert.
DevicePropertyRemovalPolicy Die aktuelle Entfernungsrichtlinie des Geräts. Das Betriebssystem verwendet diesen Wert als Hinweis, um zu bestimmen, wie das Gerät normalerweise entfernt wird. Der Eigenschaftstyp ist ein DEVICE_REMOVAL_POLICY Enumerationswert.
DevicePropertyResourceRequirements
DevicePropertyAllocatedResources
DevicePropertyContainerID

Anforderungen

Anforderung	Wert
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)

Siehe auch

IoGetDeviceProperty-