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

Статья
08/08/2023

[Применяется только к 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.
STATUS_INSUFFICIENT_RESOURCES	Драйверу не удалось выделить место для хранения строки идентификатора контейнера.

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

В следующем примере кода выполняется инициализация структуры 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)