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) |