WdfIoResourceRequirementsListRemove-Funktion (wdfresource.h)

  • Artikel

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

Weitere Informationen

WdfIoResourceRequirementsListRemoveByIoResList