Função WdfIoResourceListGetDescriptor (wdfresource.h)

  • Artigo

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

Confira também

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor