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

Статья
08/08/2023

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

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

Синтаксис

NTSTATUS WdfIoResourceListCreate(
  [in]           WDFIORESREQLIST        RequirementsList,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFIORESLIST           *ResourceList
);

Параметры

[in] RequirementsList

Дескриптор объекта framework resource-requirements-list, который представляет список требований к ресурсам устройства.

[in, optional] Attributes

Указатель на структуру, выделенную вызывающим объектом WDF_OBJECT_ATTRIBUTES , содержащую атрибуты для нового объекта. (Элемент ParentObject структуры должен иметь значение NULL.) Этот параметр является необязательным и может быть WDF_NO_OBJECT_ATTRIBUTES.

[out] ResourceList

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

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

WdfIoResourceListCreate возвращает STATUS_SUCCESS, если операция выполнена успешно.

Дополнительные возвращаемые значения см. в разделе Ошибки создания объекта платформы.

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

Указанный вызывающим объектом resource-requirements-list становится родительским для нового объекта resource-range-list. Драйвер не может изменить этот родительский элемент, а элемент ParentObject или структура WDF_OBJECT_ATTRIBUTES должны иметь значение NULL.

Примеры

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

Требования

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

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

WDF_OBJECT_ATTRIBUTES

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