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

Статья
02/07/2025

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

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

Синтаксис

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

Параметры

[in] List

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

[in] Index

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

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

WdfCmResourceListGetDescriptor возвращает указатель на структуру CM_PARTIAL_RESOURCE_DESCRIPTOR, описывающую аппаратный ресурс, который определяет параметр индекса, если значение индекса допустимо. В противном случае метод возвращает 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

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