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

Confira também

CM_PARTIAL_RESOURCE_DESCRIPTOR