Função WdfCmResourceListGetDescriptor (wdfresource.h)

  • Artigo

[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 que é usado como um índice na configuração lógica especificada por List .

Retornar valor

WdfCmResourceListGetDescriptor retorna um ponteiro para a estrutura CM_PARTIAL_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 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
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)

Confira também

CM_PARTIAL_RESOURCE_DESCRIPTOR