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