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

Статья
08/08/2023

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

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

Синтаксис

NTSTATUS WdfPdoUpdateAddressDescription(
  [in]      WDFDEVICE                             Device,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);

Параметры

[in] Device

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

[in, out] AddressDescription

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

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

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

Код возврата	Описание
STATUS_INVALID_PARAMETER	Дескриптор устройства не представляет PDO.
STATUS_INVALID_DEVICE_REQUEST	Дескриптор устройства не представляет устройство, которое было динамически перечислено, или, если элемент Size указанной структуры WDF_CHILD_ADDRESS_DESCRIPTION_HEADER не соответствует размеру существующего описания адреса устройства.

Код возврата

Описание

STATUS_INVALID_PARAMETER

Дескриптор устройства не представляет PDO.

STATUS_INVALID_DEVICE_REQUEST

Дескриптор устройства не представляет устройство, которое было динамически перечислено, или, если элемент Size указанной структуры WDF_CHILD_ADDRESS_DESCRIPTION_HEADER не соответствует размеру существующего описания адреса устройства.

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

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

Требования

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

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

WdfPdoRetrieveAddressDescription