Compartilhar via

EVT_WDF_DEVICE_RESOURCES_QUERY função de retorno de chamada (wdfpdo.h)

  • Artigo

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDeviceResourcesQuery de um driver de barramento cria uma lista de recursos que representa a configuração de inicialização de um dispositivo especificado.

Sintaxe

EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;

NTSTATUS EvtWdfDeviceResourcesQuery(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST Resources
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] Resources

Um identificador para um objeto de lista de recursos da estrutura que representa uma lista de recursos vazia.

Retornar valor

Se o driver não encontrar erros, ele deverá retornar STATUS_SUCCESS (especificando ou não recursos de configuração de inicialização). Se o driver encontrar erros, ele deverá retornar um valor NTSTATUS que NT_SUCCESS é avaliado como FALSE.

Para obter mais informações sobre os valores retornados dessa função de retorno de chamada, consulte Relatando falhas de dispositivo.

Comentários

Os drivers de barramento baseados em estrutura podem fornecer uma função de retorno de chamada EvtDeviceResourcesQuery . Para registrar essa função de retorno de chamada, os drivers de barramento chamam WdfPdoInitSetEventCallbacks.

A estrutura chama a função de retorno de chamada EvtDeviceResourcesQuery do driver de barramento para obter uma lista de recursos que especifica a configuração de inicialização do dispositivo.

O driver deve preencher o objeto de lista de recursos fornecido com recursos de hardware que representam os requisitos de inicialização para o dispositivo. Os drivers para dispositivos PnP obtêm essas informações de requisitos do BIOS do sistema.

Para criar uma lista de recursos, o driver chama métodos de objeto da lista de recursos da estrutura que adicionam recursos ao objeto resource-list representado pelo parâmetro Resources . Para obter mais informações sobre recursos de hardware e como criar listas de recursos, consulte Recursos de hardware para drivers de Framework-Based.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfpdo.h (include Wdf.h)
IRQL PASSIVE_LEVEL

Confira também

EvtDeviceResourceRequirementsQuery