WdfIoResourceListRemove-Funktion (wdfresource.h)
[Gilt nur für KMDF]
Die WdfIoResourceListRemove-Methode entfernt einen Ressourcendeskriptor aus der logischen Konfiguration einer Ressourcenanforderungsliste.
Syntax
void WdfIoResourceListRemove(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
Parameter
[in] ResourceList
Ein Handle für ein Framework resource-range-list-Objekt, 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
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Die WdfIoResourceListRemove-Methode entfernt den Ressourcendeskriptor, der dem Indexwert zugeordnet ist, den der Indexparameter angibt.
Wenn WdfIoResourceListRemove den Ressourcendeskriptor entfernt, der den Indexwert n aufweist, ändert sich der Indexwert des nächsten Ressourcendeskriptors von n+1 in n.
Weitere Informationen zu Ressourcenanforderungslisten und logischen Konfigurationen finden Sie unter Hardwareressourcen für Framework-Based Treiber.
Beispiele
Im folgenden Codebeispiel wird der erste Ressourcendeskriptor aus einer logischen Konfiguration entfernt.
WdfIoResourceListRemove(
Reslist,
0
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfresource.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |