WdfCmResourceListGetCount-Funktion (wdfresource.h)

Artikel
02/29/2024

[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 für ein 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 List-Parameter angibt.

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

Hinweise

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

Beispiele

Das folgende Codebeispiel zeigt, wie eine EvtDevicePrepareHardware-Rückruffunktion speicher-, port- und interrupt-Ressourcen in der Liste der übersetzten Hardwareressourcen finden kann, die der PnP-Manager (Plug & Play) 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	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfresource.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über