WdfCmResourceListGetCount function (wdfresource.h)

Artikel
02/22/2024

[Applies to KMDF and UMDF]

The WdfCmResourceListGetCount method returns the number of resource descriptors that are contained in a specified resource list.

Syntax

ULONG WdfCmResourceListGetCount(
  [in] WDFCMRESLIST List
);

Parameters

[in] List

A handle to a framework resource-list object that represents a list of hardware resources for a device.

Return value

WdfCmResourceListGetCount returns the number of resource descriptors that are contained in the resource list that the List parameter specifies.

A system bug check occurs if the driver supplies an invalid object handle.

Remarks

For more information about resource lists, see Hardware Resources for Framework-Based Drivers.

Examples

The following code example shows how an EvtDevicePrepareHardware callback function might locate the memory, port, and interrupt resources in the list of translated hardware resources that the Plug and Play (PnP) manager has assigned to a device.

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;
        }
    }
}

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.0
Minimum UMDF version	2.0
Header	wdfresource.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI compliance rules	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Delen via