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

  • Статья

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

Метод WdfIoResourceRequirementsListAppendIoResList добавляет логическую конфигурацию в конец списка требований к ресурсам.

Синтаксис

NTSTATUS WdfIoResourceRequirementsListAppendIoResList(
  [in] WDFIORESREQLIST RequirementsList,
  [in] WDFIORESLIST    IoResList
);

Параметры

[in] RequirementsList

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

[in] IoResList

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

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

WdfIoResourceRequirementsListAppendIoResList возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может возвращать одно из следующих значений:

Код возврата Описание
STATUS_INVALID_PARAMETER
 Указан недопустимый параметр.
STATUS_INVALID_DEVICE_REQUEST
 Указанный объект resource-requirements-list не является владельцем указанного объекта resource-range-list.
STATUS_INSUFFICIENT_RESOURCES
 Платформе не удалось выделить место для хранения объекта resource-range-list.
 

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

Комментарии

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

Примеры

В следующем примере кода показано, как функция обратного вызова EvtDeviceResourceRequirementsQuery создает пустую логическую конфигурацию и добавляет ее в список требований к ресурсам.

NTSTATUS
Example_EvtDeviceResourceRequirementsQuery(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
    NTSTATUS  status;
    WDFIORESLIST  logConfig;

    status = WdfIoResourceListCreate(
                                     RequirementsList,
                                     WDF_NO_OBJECT_ATTRIBUTES,
                                     &logConfig
                                     );
    if (!NT_SUCCESS(status)) {
        return status;
    }

    status = WdfIoResourceRequirementsListAppendIoResList(
                                             RequirementsList,
                                             logConfig
                                             );
    if (!NT_SUCCESS(status)) {
        return status;
    }
...
}

Требования

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

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

WdfIoResourceListCreate

WdfIoResourceRequirementsListInsertIoResList