Função WdfIoResourceRequirementsListGetCount (wdfresource.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

O método WdfIoResourceRequirementsListGetCount retorna o número de configurações lógicas contidas em uma lista de requisitos de recursos.

Sintaxe

ULONG WdfIoResourceRequirementsListGetCount(
  [in] WDFIORESREQLIST RequirementsList
);

Parâmetros

[in] RequirementsList

Um identificador para um objeto de lista de requisitos de recursos da estrutura que representa a lista de requisitos de recursos de um dispositivo.

Valor de retorno

WdfIoResourceRequirementsListGetCount retorna o número de configurações lógicas contidas na lista de requisitos de recursos.

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 requisitos de recursos, consulte Recursos de Hardware para drivers Framework-Based.

Exemplos

O exemplo de código a seguir mostra como um EvtDeviceFilterRemoveResourceRequirements função de retorno de chamada pode obter o número de configurações lógicas contidas em uma lista de requisitos de recurso.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{    
    ULONG count;

    count = WdfIoResourceRequirementsListGetCount(RequirementsList);
}

Requisitos

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

Compartilhar via