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

Статья
03/22/2025

[Применимо только к 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. К дополнительным возвращаемым значениям относятся:

Код возврата	Описание
СТАТУС_НЕДЕЙСТВИТЕЛЬНЫЙ_ПАРАМЕТР	Дескриптор устройства не представляет 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

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