Функция WdfIoResourceListGetDescriptor (wdfresource.h)

Статья
02/07/2025

[Применимо только к KMDF]

Метод WdfIoResourceListGetDescriptor возвращает указатель на дескриптор ресурса, содержащийся в логической конфигурации списка требований к ресурсам.

Синтаксис

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

Параметры

[in] ResourceList

Дескриптор объекта списка ресурсов платформы, представляющий логическую конфигурацию аппаратных ресурсов для устройства.

[in] Index

Отсчитываемое от нуля значение, используемое в качестве индекса в логическую конфигурацию, которая указывает ResourceList.

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

WdfIoResourceListGetDescriptor возвращает указатель на структуру IO_RESOURCE_DESCRIPTOR, описывающую аппаратный ресурс, который определяет параметр Index, если значение индекса допустимо. В противном случае метод возвращает NULL.

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

Замечания

Драйвер не может изменить содержимое структуры IO_RESOURCE_DESCRIPTOR, которая извлекается WdfIoResourceListGetDescriptor. Чтобы изменить дескриптор ресурса, драйвер может вызывать WdfIoResourceListUpdateDescriptor.

Дополнительные сведения о списках требований к ресурсам и логических конфигурациях см. в разделе Аппаратные ресурсы для драйверов Framework-Based.

Примеры

Пример кода, использующий WdfIoResourceListGetDescriptor, см. WdfIoRequirementsListIoResList.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
заголовка	wdfresource.h (включая Wdf.h)
библиотеки	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	<=DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor

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