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


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

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

Метод WdfCmResourceListRemove удаляет дескриптор ресурса из указанного списка ресурсов.

Синтаксис

void WdfCmResourceListRemove(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

Параметры

[in] List

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

[in] Index

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

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

Никакой

Замечания

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

Метод WdfCmResourceListRemove удаляет дескриптор ресурса, связанный со значением индекса, указанным параметром индекса.

Если WdfCmResourceListRemove удаляет дескриптор ресурса, имеющий значение индекса n, значение индекса следующего дескриптора ресурса изменяется с n+1 на n.

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

Примеры

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

NTSTATUS
MyEvtDeviceRemoveAddedResources(
    WDFDEVICE Device,
    WDFCMRESLIST ResourcesRaw,
    WDFCMRESLIST ResourcesTranslated
    )
{
...
    WdfCmResourceListRemove(
                            ResourcesRaw,
                            2
                            );
    WdfCmResourceListRemove(
                            ResourcesTranslated,
                            2
                            );
...

}

Требования

Требование Ценность
целевая платформа Всеобщий
минимальная версия KMDF 1.0
заголовка wdfresource.h (включая Wdf.h)
библиотеки Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL <=DISPATCH_LEVEL
правил соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WdfCmResourceListRemoveByDescriptor