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


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

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

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

Синтаксис

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

Параметры

[in] RequirementsList

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

[in] Index

Отсчитываемое от нуля значение, которое используется в качестве индекса в списке требований к ресурсам, заданном RequirementsList .

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

None

Remarks

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

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

Когда WdfIoResourceRequirementsListRemove удаляет логическую конфигурацию со значением индекса n, значение индекса следующей логической конфигурации изменяется с n+1 на n.

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

Примеры

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

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

Требования

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

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

WdfIoResourceRequirementsListRemoveByIoResList