Функция WdfPdoRetrieveAddressDescription (wdfpdo.h)
[Относится только к KMDF]
Метод WdfPdoRetrieveAddressDescription извлекает описание адреса , связанное с указанным объектом устройства платформы.
Синтаксис
NTSTATUS WdfPdoRetrieveAddressDescription(
[in] WDFDEVICE Device,
[in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);
Параметры
[in] Device
Дескриптор объекта устройства платформы, который представляет объект физического устройства (PDO).
[in, out] AddressDescription
Указатель на буфер, выделенный вызывающим объектом, который получит описание адреса. Описание адреса должно содержать структуру WDF_CHILD_ADDRESS_DESCRIPTION_HEADER .
Возвращаемое значение
Если операция выполнена успешно, функция возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:
Код возврата | Описание |
---|---|
|
Дескриптор устройства не представляет PDO. |
|
Дескриптор устройства не представляет устройство, которое было перечислено динамически. |
Метод также может возвращать другие значения NTSTATUS.
Системная ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Требования
Требование | Значение |
---|---|
Целевая платформа | Универсальное |
Минимальная версия KMDF | 1,0 |
Верхняя часть | wdfpdo.h (включая Wdf.h) |
Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы). |
IRQL | <= DISPATCH_LEVEL |
Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
См. также раздел
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT