Функция 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, если операция выполнена успешно. В противном случае этот метод может возвращать одно из следующих значений:
Код возврата | Описание |
---|---|
|
Указан недопустимый параметр. |
|
Указанный объект resource-requirements-list не является владельцем указанного объекта resource-range-list. |
|
Платформе не удалось выделить место для хранения объекта 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) |