通过

DEVICE_REGISTRY_PROPERTY枚举 （wdm.h）

  • 项目

DEVICE_REGISTRY_PROPERTY 枚举标识存储在注册表中的设备属性。

语法

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;

常数

 
DevicePropertyDeviceDescription
描述设备的字符串，例如“Microsoft PS/2 端口鼠标”，通常由制造商定义。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyHardwareID
标识设备提供的硬件 ID。 属性类型是REG_MULTI_SZ值。
DevicePropertyCompatibleIDs
设备报告的 兼容 ID。 属性类型是REG_MULTI_SZ值。
DevicePropertyBootConfiguration
固件以原始形式分配给设备的硬件资源。 属性类型是 CM_RESOURCE_LIST 结构。
DevicePropertyBootConfigurationTranslated
固件分配给设备的硬件资源，格式已转换。 属性类型是 CM_RESOURCE_LIST 结构。
DevicePropertyClassName
设备设置类的名称，采用文本格式。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyClassGuid
设备的设置类的 GUID。 属性类型是 WCHAR 的 NULL 终止数组。

字符串格式的 GUID 如下所示，其中每个“c”表示十六进制字符：{cccccccc-cccc-cccc-cccc-cccc-cc}
DevicePropertyDriverKeyName
特定于驱动程序的注册表项的名称。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyManufacturer
标识设备的制造商的字符串。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyFriendlyName
可用于区分两个类似设备的字符串，通常由类安装程序定义。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyLocationInformation
有关设备在总线上的位置的信息;此信息的解释特定于总线。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyPhysicalDeviceObjectName
此设备的 PDO 的名称。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyBusTypeGuid
设备连接到的总线的 GUID。 系统定义的总线类型 GUID 列在 Wdmguid.h 头文件中。 属性类型是 GUID，它是一个包含二进制形式的 GUID 的 16 字节结构。
DevicePropertyLegacyBusType
请求总线类型，例如 PCIBus 或 PCMCIABus。 属性类型是 INTERFACE_TYPE 枚举值。
DevicePropertyBusNumber
设备连接到的总线的旧总线编号。 属性类型为 ULONG。
DevicePropertyEnumeratorName
设备的枚举器的名称，例如“PCI”或“root”。 属性类型是以 NULL 结尾的 WCHAR 字符串。
DevicePropertyAddress
总线上的设备的地址。 属性类型为 ULONG。

此地址的解释特定于总线。 此例程的调用方应再次调用例程以请求 DevicePropertyBusTypeGuid，或者 DevicePropertyLegacyBusType，以便它可以解释地址。 0xFFFFFFFF的地址值指示基础总线驱动程序未为设备提供总线地址。

以下列表描述了其子设备的某些总线驱动程序存储的信息：

 总线 描述
----- -------------
1394 不提供地址，因为地址是可变的。 默认为0xFFFFFFFF。
EISA 槽号 （0-F）。
IDE 对于 IDE 设备，地址包含目标 ID 和 LUN。 对于 IDE 通道，地址为零或 1（0 = 主通道，1 = 辅助通道）。
ISApnp 不提供地址。 默认为0xFFFFFFFF。
电脑卡 （PCMCIA） 套接字号（通常0x00或0x40）。
PCI 高单词中的设备编号和低单词中的函数编号。
SCSI 目标 ID。
USB 端口号。
DevicePropertyUINumber
与可在用户界面中显示的设备关联的数字。 属性类型为 ULONG 值。

此数字通常是用户感知的槽号，例如在板上的槽旁边打印的数字，或者一些其他数字，使用户更容易找到物理设备。 如果设备位于没有 UI 号码约定的总线上，或者设备的总线驱动程序无法确定 UI 编号，则此值0xFFFFFFFF。
DevicePropertyInstallState
设备的安装状态。 属性类型是一个 DEVICE_INSTALL_STATE 枚举值。
DevicePropertyRemovalPolicy
设备的当前删除策略。 作系统使用此值作为提示来确定设备正常删除的方式。 属性类型是 DEVICE_REMOVAL_POLICY 枚举值。
DevicePropertyResourceRequirements
DevicePropertyAllocatedResources
DevicePropertyContainerID

要求

要求 价值
标头 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h）

另请参阅

IoGetDeviceProperty