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


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

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

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

Синтаксис

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

Параметры

[in] List

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

[in] Index

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

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

None

Remarks

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

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

Когда 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