Функция 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.

Требования

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

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor