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

[Применимо только к KMDF]

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

Синтаксис

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

Параметры

[in] RequirementsList

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

[in] Index

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

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

Никакой

Замечания

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

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

Если WdfIoRequirementsListRemove удаляет логическую конфигурацию, которая имеет значение индекса 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