Funzione WdfCmResourceListGetCount (wdfresource.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfCmResourceListGetCount restituisce il numero di descrittori di risorse contenuti in un elenco di risorse specificato.

Sintassi

ULONG WdfCmResourceListGetCount(
  [in] WDFCMRESLIST List
);

Parametri

[in] List

Handle per un oggetto elenco di risorse framework che rappresenta un elenco di risorse hardware per un dispositivo.

Valore restituito

WdfCmResourceListGetCount restituisce il numero di descrittori di risorse contenuti nell'elenco di risorse specificato dal parametro list.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo dei bug di sistema.

Osservazioni

Per altre informazioni sugli elenchi di risorse, vedere Risorse hardware per driver Framework-Based.

Esempi

L'esempio di codice seguente mostra come un EvtDevicePrepareHardware funzione di callback potrebbe individuare le risorse di memoria, porta e interrupt nell'elenco di risorse hardware tradotte che il gestore Plug and Play (PnP) ha assegnato a un dispositivo.

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfresource.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Condividi tramite