WdfCmResourceListGetCount-Funktion (wdfresource.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfCmResourceListGetCount Methode gibt die Anzahl der Ressourcendeskriptoren zurück, die in einer angegebenen Ressourcenliste enthalten sind.

Syntax

ULONG WdfCmResourceListGetCount(
  [in] WDFCMRESLIST List
);

Parameter

[in] List

Ein Handle zu einem Framework-Ressourcenlistenobjekt, das eine Liste der Hardwareressourcen für ein Gerät darstellt.

Rückgabewert

WdfCmResourceListGetCount gibt die Anzahl der Ressourcendeskriptoren zurück, die in der Ressourcenliste enthalten sind, die der parameter List angibt.

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

Bemerkungen

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

Beispiele

Das folgende Codebeispiel zeigt, wie eine EvtDevicePrepareHardware Rückruffunktion den Speicher, portieren und Unterbrechen von Ressourcen in der Liste der übersetzten Hardwareressourcen, die der Manager für Plug and Play (PnP) einem Gerät zugewiesen hat.

NTSTATUS
MyEvtDevicePrepareHardware (
    WDFDEVICE  Device,
    WDFCMRESLIST  Resources,
    WDFCMRESLIST  ResourcesTranslated
    )
{
    ULONG  i;
    PCM_PARTIAL_RESOURCE_DESCRIPTOR  desc;

    for (i = 0; i < WdfCmResourceListGetCount(ResourcesTranslated); i++) {

        desc = WdfCmResourceListGetDescriptor(
                                              ResourcesTranslated,
                                              i
                                              );

        switch (desc->Type) {

            case CmResourceTypeMemory:
                //
                // Handle memory resources here.
                //
                break;

            case CmResourceTypePort:
                //
                // Handle port resources here.
                //
                break;

            case CmResourceTypeInterrupt:
                //
                // Handle interrupt resources here.
                //
                break;
            default:
                //
                // Ignore all other descriptors.
                //
                break;
        }
    }
}

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfresource.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über