WdfIoResourceListRemove-Funktion (wdfresource.h)

Artikel
02/27/2024

[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

Freigeben über