Funzione WdfCmResourceListGetCount (wdfresource.h)

Articolo
02/27/2024

[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 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 .

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

Commenti

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

Esempio

L'esempio di codice seguente mostra come una funzione di callback EvtDevicePrepareHardware potrebbe individuare le risorse di memoria, porta e interrupt nell'elenco delle risorse hardware tradotte assegnate dal manager Plug and Play (PnP) 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;
        }
    }
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	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