Поделиться через

перечисление 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 Port Mouse", обычно определяемая производителем. Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyHardwareID
идентификаторы оборудования, предоставляемые устройством, которое определяет устройство. Тип свойства — это REG_MULTI_SZ значение.
DevicePropertyCompatibleIDs
совместимые идентификаторы, сообщаемые устройством. Тип свойства — это REG_MULTI_SZ значение.
DevicePropertyBootConfiguration
Аппаратные ресурсы, назначенные устройству встроенного ПО, в необработанной форме. Тип свойства — это структура CM_RESOURCE_LIST.
DevicePropertyBootConfigurationTranslated
Аппаратные ресурсы, назначенные устройству встроенного ПО, в преобразованной форме. Тип свойства — это структура CM_RESOURCE_LIST.
DevicePropertyClassName
Имя класса установки устройства в текстовом формате. Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyClassGuid
GUID для класса установки устройства. Тип свойства — это массив WCHAR, завершающий значение NULL.

GUID в строковом формате, как показано ниже, где каждый объект c представляет шестнадцатеричный символ: {cc-cc}
DevicePropertyDriverKeyName
Имя раздела реестра для конкретного драйвера. Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyManufacturer
Строка, определяющая производителя устройства. Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyFriendlyName
Строка, которую можно использовать для различения двух аналогичных устройств, обычно определенных установщиком классов. Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyLocationInformation
Сведения о расположении устройства на шине; Интерпретация этих сведений зависит от шины. Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyPhysicalDeviceObjectName
Имя PDO для этого устройства. Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyBusTypeGuid
GUID для шины, к которому подключено устройство. Идентификаторы guid типа шины, определяемые системой, перечислены в файле заголовка Wdmguid.h. Тип свойства — это GUID, который представляет собой 16-байтовую структуру, содержащую GUID в двоичной форме.
DevicePropertyLegacyBusType
Запрашивает тип шины, например PCIBus или PCMCIABus. Тип свойства — это значение перечисления INTERFACE_TYPE.
DevicePropertyBusNumber
Устаревший номер шины, к которому подключено устройство. Тип свойства — ULONG.
DevicePropertyEnumeratorName
Имя перечислителя для устройства, например "PCI" или "root". Тип свойства представляет собой строку WCHAR, завершаемую null.
DevicePropertyAddress
Адрес устройства на шине. Тип свойства — ULONG.

Интерпретация этого адреса зависит от шины. Вызывающий этот подпрограмма должен снова вызвать подпрограмму, чтобы запросить DevicePropertyBusTypeGuidили, возможно, DevicePropertyLegacyBusType, чтобы он мог интерпретировать адрес. Значение адреса 0xFFFFFFFF указывает, что базовый водитель шины не указал адрес шины для устройства.

В следующем списке описаны сведения о некоторых драйверах шины для своих дочерних устройств:

 Автобус Описание
----- -------------
1394 Не предоставляет адрес, так как адреса являются переменными. По умолчанию 0xFFFFFFFF.
EISA Номер слота (0-F).
ЯЗЬ Для устройства интегрированной среды разработки адрес содержит целевой идентификатор и LUN. Для канала интегрированной среды разработки адрес равен нулю или одному (0 = первичный канал и 1 = вторичный канал).
ISApnp Не предоставляет адрес. По умолчанию 0xFFFFFFFF.
Pc Card (PCMCIA) Номер сокета (обычно 0x00 или 0x40).
PCI Номер устройства в высоком слове и номер функции в низком слове.
SCSI Идентификатор целевого объекта.
USB Номер порта.
DevicePropertyUINumber
Номер, связанный с устройством, которое можно отобразить в пользовательском интерфейсе. Тип свойства — это значение ULONG.

Обычно это номер слота, который воспринимается пользователем, например число, напечатанное рядом с слотом на доске, или другое число, которое упрощает поиск физического устройства для пользователя. Если устройство находится на шине без соглашения о номере пользовательского интерфейса или если драйвер шины для устройства не может определить номер пользовательского интерфейса, это значение 0xFFFFFFFF.
DevicePropertyInstallState
Состояние установки устройства. Тип свойства — это значение перечисления DEVICE_INSTALL_STATE.
DevicePropertyRemovalPolicy
Текущая политика удаления устройства. Операционная система использует это значение в качестве указания, чтобы определить, как устройство обычно удаляется. Тип свойства — это значение перечисления DEVICE_REMOVAL_POLICY.
DevicePropertyResourceRequirements
DevicePropertyAllocatedResources
DevicePropertyContainerID

Требования

Требование Ценность
заголовка wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)

См. также

IoGetDeviceProperty