WdfIoResourceRequirementsListRemove-Funktion (wdfresource.h)
[Gilt nur für KMDF]
Die WdfIoResourceRequirementsListRemove-Methode entfernt eine logische Konfiguration aus einer Ressourcenanforderungenliste.
Syntax
void WdfIoResourceRequirementsListRemove(
[in] WDFIORESREQLIST RequirementsList,
[in] ULONG Index
);
Parameter
[in] RequirementsList
Ein Handle für ein Framework resource-requirements-list-Objekt, das die Ressourcenbedarfsliste eines Geräts darstellt.
[in] Index
Ein nullbasierter Wert, der als Index in der Ressourcenanforderungenliste verwendet wird, die RequirementsList angibt.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Die WdfIoResourceRequirementsListRemove-Methode entfernt die logische Konfiguration, die dem Indexwert zugeordnet ist, den der Index-Parameter angibt.
Wenn WdfIoResourceRequirementsListRemove die logische Konfiguration entfernt, die den Indexwert n aufweist, ändert sich der Indexwert der nächsten logischen Konfiguration von n+1 auf n.
Weitere Informationen zu Ressourcenanforderungenlisten finden Sie unter Hardwareressourcen für Framework-Based Treiber.
Beispiele
Im folgenden Codebeispiel wird die zweite logische Konfiguration aus einer Ressourcenanforderungenliste entfernt.
NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
IN WDFDEVICE Device,
IN WDFIORESREQLIST RequirementsList
)
{
...
WdfIoResourceRequirementsListRemove(
RequirementsList,
1
);
...
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfresource.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |