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

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDeviceResourcesQuery de um driver de ônibus cria uma lista de recursos que representa a configuração de inicialização de 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.

Valor de retorno

Se o driver não tiver encontrado 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.

Observações

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 motoristas de barramento chamam WdfPdoInitSetEventCallbacks.

A estrutura chama a função de retorno de chamada EvtDeviceResourcesQuery do driver de ônibus 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 de lista de recursos representado pelo parâmetro recursos do. Para obter mais informações sobre os recursos de hardware e a criação de listas de recursos, consulte Recursos de Hardware para drivers de Framework-Based.

Requisitos

Consulte também

EvtDeviceResourceRequirementsQuery