Função WdfCmResourceListGetCount (wdfresource.h)

Artigo
02/07/2025

[Aplica-se a KMDF e UMDF]

O método WdfCmResourceListGetCount retorna o número de descritores de recursos contidos em uma lista de recursos especificada.

Sintaxe

ULONG WdfCmResourceListGetCount(
  [in] WDFCMRESLIST List
);

Parâmetros

[in] List

Um identificador para um objeto de lista de recursos da estrutura que representa uma lista de recursos de hardware para um dispositivo.

Valor de retorno

WdfCmResourceListGetCount retorna o número de descritores de recursos contidos na lista de recursos especificada pelo parâmetro lista de.

Uma verificação de bugs do sistema ocorre se o driver fornece um identificador de objeto inválido.

Observações

Para obter mais informações sobre listas de recursos, consulte Recursos de Hardware para drivers de Framework-Based.

Exemplos

O exemplo de código a seguir mostra como uma função de retorno de chamada EvtDevicePrepareHardware pode localizar os recursos de memória, porta e interrupção na lista de recursos de hardware traduzidos que o gerenciador do Plug and Play (PnP) atribuiu a um 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;
        }
    }
}

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	wdfresource.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Compartilhar via