Função WdfIoResourceListGetDescriptor (wdfresource.h)
[Aplica-se somente ao KMDF]
O método WdfIoResourceListGetDescriptor retorna um ponteiro para um descritor de recursos contido na configuração lógica de uma lista de requisitos de recursos.
Sintaxe
PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
Parâmetros
[in] ResourceList
Um identificador para um objeto de lista de intervalo de recursos de estrutura que representa uma configuração lógica de recursos de hardware para um dispositivo.
[in] Index
Um valor baseado em zero que é usado como um índice na configuração lógica especificada pelo ResourceList .
Retornar valor
WdfIoResourceListGetDescriptor retorna um ponteiro para a estrutura IO_RESOURCE_DESCRIPTOR que descreve o recurso de hardware identificado pelo parâmetro Index , se o valor do índice for válido. Caso contrário, o método retornará NULL.
Um bug do sistema marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Comentários
O driver não pode modificar o conteúdo da estrutura IO_RESOURCE_DESCRIPTOR que o WdfIoResourceListGetDescriptor recupera. Para modificar um descritor de recursos, o driver pode chamar WdfIoResourceListUpdateDescriptor.
Para obter mais informações sobre listas de requisitos de recursos e configurações lógicas, consulte Recursos de hardware para drivers de Framework-Based.
Exemplos
Para obter um exemplo de código que usa WdfIoResourceListGetDescriptor, consulte WdfIoResourceRequirementsListGetIoResList.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfresource.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |