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

[Относится только к 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, если операция выполнена успешно.

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

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

Комментарии

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

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

Примеры

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

Требования

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

WDF_OBJECT_ATTRIBUTES