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

  • Статья

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

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

Синтаксис

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

Параметры

[in] ResourceList

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

[in] Index

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

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

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

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

Комментарии

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

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

Примеры

Пример кода, в котором используется WdfIoResourceListGetDescriptor, см. в разделе WdfIoRequirementsListGetIoResList.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия 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