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

Статья
02/27/2024

[Относится только к KMDF]

Метод WdfPdoRetrieveIdentificationDescription извлекает описание идентификации , связанное с указанным объектом устройства платформы.

Синтаксис

NTSTATUS WdfPdoRetrieveIdentificationDescription(
  [in]      WDFDEVICE                                    Device,
  [in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Параметры

[in] Device

Дескриптор объекта устройства платформы, который представляет объект физического устройства (PDO).

[in, out] IdentificationDescription

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

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

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

Код возврата	Описание
STATUS_INVALID_PARAMETER	Дескриптор устройства не представляет PDO.
STATUS_INVALID_DEVICE_REQUEST	Дескриптор устройства не представляет устройство, которое было динамически перечислено, или, если структура WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER не содержит правильный размер буфера.

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

Системная ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Верхняя часть	wdfpdo.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы).
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также раздел

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfPdoRetrieveAddressDescription

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