Функция 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) |