WdfIoResourceRequirementsListRemove-Funktion (wdfresource.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WdfIoResourceRequirementsListRemove-methode entfernt eine logische Konfiguration aus einer Ressourcenanforderungsliste.

Syntax

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

Parameter

[in] RequirementsList

Ein Handle für ein Framework-Ressourcenanforderungen-Listenobjekt, das die Ressourcenanforderungensliste eines Geräts darstellt.

[in] Index

Ein nullbasierter Wert, der als Index in der Liste der Ressourcenanforderungen verwendet wird, die RequirementsList- angibt.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

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 naufweist, ändert sich der Indexwert der nächsten logischen Konfiguration von n+1 in n.

Weitere Informationen zu Ressourcenanforderungenslisten finden Sie unter Hardwareressourcen für Framework-Based Drivers.

Beispiele

Im folgenden Codebeispiel wird die zweite logische Konfiguration aus einer Ressourcenanforderungensliste entfernt.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

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)

Siehe auch

WdfIoResourceRequirementsListRemoveByIoResList

Freigeben über