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

2025-03-22

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

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

Синтаксис

NTSTATUS WdfPdoInitAssignContainerID(
  [in] PWDFDEVICE_INIT  DeviceInit,
  [in] PCUNICODE_STRING ContainerID
);

Параметры

[in] DeviceInit

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

[in] ContainerID

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

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

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

Код возврата	Описание
STATUS_INVALID_DEVICE_REQUEST	Драйвер инициализирует FDO вместо PDO.
СТАТУС_НЕДОСТАТОЧНЫЕ_РЕСУРСЫ	Драйвер не мог выделить место для хранения строки идентификатора контейнера.

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

Замечания

Дополнительные сведения об идентификаторах контейнеров см. в строках идентификации устройств.

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

Примеры

Следующий пример кода инициализирует структуру UNICODE_STRING, сохраняет строку Юникода в структуре, а затем регистрирует строку Юникода в качестве идентификатора контейнера устройства.

UNICODE_STRING containerId = {0}; 

RtlInitUnicodeString(
                     &containerId,
                     strContainerId //Unicode string for container ID
                     );
status = WdfPdoInitAssignContainerID(
                                     pDeviceInit,
                                     &containerId
                                     );

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.9
Заголовок	wdfpdo.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	DriverCreate(kmdf)