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

Статья
03/22/2025

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

Код возврата	Описание
СТАТУС_НЕДЕЙСТВИТЕЛЬНЫЙ_ПАРАМЕТР	Дескриптор устройства не представляет PDO.
STATUS_INVALID_DEVICE_REQUEST	Дескриптор устройства не представляет устройство, которое было динамически перечисляетсяили если элемент размера указанной структуры WDF_CHILD_ADDRESS_DESCRIPTION_HEADER не соответствует размеру существующего описания адреса устройства.

Код возврата

Описание

СТАТУС_НЕДЕЙСТВИТЕЛЬНЫЙ_ПАРАМЕТР

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

STATUS_INVALID_DEVICE_REQUEST

Дескриптор устройства не представляет устройство, которое было динамически перечисляетсяили если элемент размера указанной структуры 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

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