Função WdfCmResourceListGetDescriptor (wdfresource.h)
[Aplica-se a KMDF e UMDF]
O método WdfCmResourceListGetDescriptor retorna um ponteiro para um descritor de recursos contido em uma lista de recursos especificada.
Sintaxe
PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
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.
[in] Index
Um valor baseado em zero usado como um índice na configuração lógica especificada List.
Valor de retorno
WdfCmResourceListGetDescriptor retorna um ponteiro para a estrutura de CM_PARTIAL_RESOURCE_DESCRIPTOR que descreve o recurso de hardware que o parâmetro Index identifica, se o valor do índice for válido. Caso contrário, o método retornará NULL.
Uma verificação de bugs do sistema ocorre se o driver fornece um identificador de objeto inválido.
Observações
O driver não pode modificar o descritor de recursos que o WdfCmResourceListGetDescriptor recupera.
Para obter mais informações sobre listas de recursos, consulte Recursos de Hardware para drivers de Framework-Based.
Exemplos
Para obter um exemplo de código que usa WdfCmResourceListGetDescriptor, consulte WdfCmResourceListGetCount.
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) |