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的地址值指示基础总线驱动程序未为设备提供总线地址。

有关其他特定于总线驱动程序的信息,请参阅 “备注 ”。
DevicePropertyUINumber
与可在用户界面中显示的设备关联的数字。 属性类型为 ULONG 值。

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

注解

对于 DevicePropertyAddress 值,以下列表描述了某些总线驱动程序为其子设备存储的信息:

总线 描述
1394 不提供地址,因为地址是可变的。 默认为0xFFFFFFFF。
EISA 槽号 (0-F)。
IDE 对于 IDE 设备,地址包含目标 ID 和 LUN。 对于 IDE 通道,地址为零或 1(0 = 主通道,1 = 辅助通道)。
ISApnp 不提供地址。 默认为0xFFFFFFFF。
电脑卡 (PCMCIA) 套接字号(通常0x00或0x40)。
PCI 高单词中的设备编号和低单词中的函数编号。
SCSI 目标 ID。
USB 端口号。

要求

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

另请参阅

IoGetDeviceProperty