在Windows Vista及更高版本的Windows中,统一设备属性模型包括设备关系属性。 统一设备属性模型使用 属性键 来表示这些属性。 统一设备属性模型中表示的关系列表包括:
- DEVPKEY_Device_BusRelations
- DEVPKEY_Device_EjectionRelations
- DEVPKEY_Device_PowerRelations
- DEVPKEY_Device_RemovalRelations
- DEVPKEY_Device_Parent
- DEVPKEY_Device_Children
- DEVPKEY_Device_Siblings
Windows Server 2003、Windows XP 和 Windows 2000 不支持统一属性模型的属性键。 但是,可以通过调用 即插即用 (PnP) 配置管理器函数来检索相应的信息。 为了保持与早期Windows版本的兼容性,Windows Vista和更高版本还支持调用 PnP 配置管理器函数来检索设备关系属性。 但是,应使用统一设备属性模型的属性键来访问设备关系属性。有关如何使用属性键访问设备驱动程序属性的信息,请参阅访问设备实例属性(Windows Vista及更高版本)。
有关如何访问 Windows Server 2003、Windows XP 和 Windows 2000 上的设备关系属性的信息,请参阅以下主题:
检索弹出关系、移除关系和电源关系以及总线关系
若要检索有关 Windows Server 2003、Windows XP 和 Windows 2000 的设备关系信息,请调用CM_Get_Device_ID_List并提供以下参数值:
将 pszFilter 设置为指向 NULL 终止的字符串的指针,该字符串指定要为其检索关系信息的设备实例标识符。
将 Buffer 设置为指向接收 NULL 终止设备实例标识符列表的缓冲区的指针。 该列表以额外的 NULL 字符结尾。 可以通过调用 CM_Get_Device_ID_List_Size 函数来获取所需的缓冲区大小。
将 BufferLen 设置为 Buffer 缓冲区的大小(以字符为单位)。
将 ulFlags 设置为以下标志之一以检索相应的关系信息:
CM_GETIDLIST_FILTER_EJECTIONRELATIONS
CM_GETIDLIST_FILTER_EJECTIONRELATIONS 标志可检索弹出关系,这些信息与 Windows Vista 及更高版本中 DEVPKEY_Device_EjectionRelations 设备属性提供的信息相同。
CM_GETIDLIST_FILTER_REMOVALRELATIONS
CM_GETIDLIST_FILTER_REMOVALRELATIONS标志检索移除关系,该关系与Windows Vista及更高版本中DEVPKEY_Device_RemovalRelations设备属性提供的信息相同。
CM_GETIDLIST_FILTER_POWERRELATIONS
CM_GETIDLIST_FILTER_POWERRELATIONS标志检索电源关系,该关系与 Windows Vista 及更高版本中DEVPKEY_Device_PowerRelations设备属性提供的信息相同。
CM_GETIDLIST_FILTER_BUSRELATIONS
CM_GETIDLIST_FILTER_BUSRELATIONS标志检索总线关系,该关系与Windows Vista及更高版本中DEVPKEY_Device_BusRelations设备属性提供的信息相同。
如果调用 CM_Get_Device_ID_List 成功, CM_Get_Device_ID_List 检索请求的关系信息并返回CR_SUCCESS。 否则, CM_Get_Device_ID_List 返回在 Cfgmgr32.h 中定义的前缀为“CR_”的错误代码之一。
检索设备实例的父级
若要在 Windows Server 2003、Windows XP 和 Windows 2000 上检索父设备的设备实例标识符,请执行以下步骤:
调用 CM_Get_Parent 函数以检索设备实例的父设备的设备实例句柄。
调用 CM_Get_Device_ID 检索与上一次调用 CM_Get_Parent 检索到的父设备的设备实例句柄关联的设备实例标识符。
使用此过程检索的此信息与Windows Vista及更高版本中统一设备属性模型中DEVPKEY_Device_Parent属性所表示的信息相同。
检索设备实例的子级
若要在 Windows Server 2003、Windows XP 和 Windows 2000 上检索设备实例的子设备的设备实例标识符,请执行以下步骤:
调用 CM_Get_Child 函数,以检索与设备实例关联的第一个子设备的设备实例句柄。
根据需要多次调用 CM_Get_Sibling,以枚举通过调用 CM_Get_Child 检索到的第一个子设备的所有同级设备。
调用 CM_Get_Device_ID 检索与调用 CM_Get_Child 和 CM_Get_Sibling返回的设备实例句柄关联的设备实例标识符。
使用此过程检索到的此信息与Windows Vista及更高版本中统一设备属性模型中DEVPKEY_Device_Children属性所表示的信息相同。
检索设备实例的同级设备
若要在 Windows Server 2003、Windows XP 和 Windows 2000 上检索设备实例 Abc 的同级设备的设备实例标识符,请执行以下步骤:
调用 CM_Get_Parent 函数以检索设备实例 Abc 的父设备的设备实例句柄。
调用 CM_Get_Child 函数,以检索设备实例 Abc 父设备的第一个子设备的设备实例句柄。
根据需要多次调用 CM_Get_Sibling 来枚举父设备的第一个子设备的所有同级设备。 此枚举还将返回设备实例 Abc 的句柄。
调用 CM_Get_Device_ID 检索与之前调用 CM_Get_Sibling返回的设备实例句柄关联的设备实例标识符。 从父设备的第一个子设备的同级设备列表中删除设备实例 Abc 的句柄。
使用此过程检索的信息与Windows Vista及更高版本中统一设备属性模型中DEVPKEY_Device_Siblings属性所表示的信息相同。 如果本节中列出的 CM_Xxx 函数调用成功, CM_Xxx 函数将检索请求的信息并返回CR_SUCCESS。 否则, CM_Xxx 函数返回在 Cfgmgr32.h 中定义的前缀为“CR_”的错误代码之一。