WdfIoResourceListRemove-Funktion (wdfresource.h)

  • Artikel

[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)

Weitere Informationen

WdfIoResourceListRemoveByDescriptor