Функция WdfPdoInitAddHardwareID (wdfpdo.h)

[Применимо только к KMDF]

Метод WdfPdoInitAddHardwareID добавляет идентификатор оборудования в список идентификаторов оборудования для дочернего устройства.

Синтаксис

NTSTATUS WdfPdoInitAddHardwareID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING HardwareID
);

Параметры

[in] DeviceInit

Указатель на структуру WDFDEVICE_INIT.

[in] HardwareID

Указатель на структуру UNICODE_STRING, содержащую строку идентификатора оборудования. Драйвер может выделить буфер строки из пула страниц.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Метод также может возвращать другие значения NTSTATUS.

Замечания

Драйвер может добавить один или несколько идентификаторов оборудования для устройства. Они должны быть добавлены в порядок от лучшего матча до худшего матча. Платформа предоставит идентификаторы диспетчеру PnP в том порядке, в который они были добавлены. Дополнительные сведения об идентификаторах оборудования см. в строках идентификации устройств и способа выбора драйверов.

Драйвер должен вызывать WdfPdoInitAddHardwareID перед вызовом WdfDeviceCreate. Дополнительные сведения о вызове WdfDeviceCreateсм. в создании объекта устройства Framework.

Примеры

В следующем примере кода сообщается идентификатор оборудования, который использует KbFiltr пример драйвера.

#define  KBFILTR_DEVICE_ID L"{A65C87F9-BE02-4ed9-92EC-012D416169FA}\\KeyboardFilter\0"
DECLARE_CONST_UNICODE_STRING(hardwareId, KBFILTR_DEVICE_ID);

status = WdfPdoInitAddHardwareID(
                                 pDeviceInit,
                                 &hardwareId
                                 );

Требования

См. также

WdfPdoInitAddCompatibleID

WdfPdoInitAssignDeviceID

WdfPdoInitAssignInstanceID