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

  • Статья

[Применимо к KMDF и UMDF]

Метод WdfCmResourceListGetDescriptor возвращает указатель на дескриптор ресурса, содержащийся в указанном списке ресурсов.

Синтаксис

PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

Параметры

[in] List

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

[in] Index

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

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

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

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

Комментарии

Драйвер не может изменить дескриптор ресурса, извлекаемого WdfCmResourceListGetDescriptor .

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

Примеры

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

Требования

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

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

CM_PARTIAL_RESOURCE_DESCRIPTOR