WdfIoResourceRequirementsListGetCount-Funktion (wdfresource.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die WdfIoResourceResourceRequirementsListGetCount-Methode gibt die Anzahl der logischen Konfigurationen zurück, die in einer Ressourcenanforderungsliste enthalten sind.

Syntax

ULONG WdfIoResourceRequirementsListGetCount(
  [in] WDFIORESREQLIST RequirementsList
);

Parameter

[in] RequirementsList

Ein Handle für ein Framework resource-requirements-list-Objekt, das die Ressourcenanforderungsliste eines Geräts darstellt.

Rückgabewert

WdfIoResourceRequirementsListGetCount gibt die Anzahl der logischen Konfigurationen zurück, die in der Liste der Ressourcenanforderungen enthalten sind.

Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Weitere Informationen zu Ressourcenanforderungenlisten finden Sie unter Hardwareressourcen für Framework-Based Treiber.

Beispiele

Das folgende Codebeispiel zeigt, wie eine EvtDeviceFilterRemoveResourceRequirements-Rückruffunktion die Anzahl der logischen Konfigurationen abrufen kann, die in einer Ressourcenanforderungsliste enthalten sind.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{    
    ULONG count;

    count = WdfIoResourceRequirementsListGetCount(RequirementsList);
}

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)

Freigeben über