WdfIoResourceListRemove-Funktion (wdfresource.h)
[Gilt nur für KMDF]
Die WdfIoResourceListRemove Methode entfernt einen Ressourcendeskriptor aus der logischen Konfigurationeiner Ressourcenanforderungsliste.
Syntax
void WdfIoResourceListRemove(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
Parameter
[in] ResourceList
Ein Handle zu einem Framework-Ressourcenbereichslistenobjekt, das eine logische Konfiguration von Hardwareressourcen für ein Gerät darstellt.
[in] Index
Ein nullbasierter Wert, der als Index in der logischen Konfiguration verwendet wird, die ResourceList- angibt.
Rückgabewert
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Die WdfIoResourceListRemove -Methode entfernt den Ressourcendeskriptor, der dem Indexwert zugeordnet ist, den der Index Parameter angibt.
Wenn WdfIoResourceListRemove den Ressourcendeskriptor entfernt, der den Indexwert nenthält, ändert sich der Indexwert des nächsten Ressourcendeskriptors von n+1 in n.
Weitere Informationen zu Ressourcenanforderungenlisten und logischen Konfigurationen finden Sie unter Hardwareressourcen für Framework-Based Drivers.
Beispiele
Im folgenden Codebeispiel wird der erste Ressourcendeskriptor aus einer logischen Konfiguration entfernt.
WdfIoResourceListRemove(
Reslist,
0
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfresource.h (include Wdf.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |