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

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDeviceResourceRequirementsQuery de um driver de barramento cria uma lista de requisitos de recursos que representa os recursos de hardware necessários do dispositivo.

Sintaxe

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] IoResourceRequirementsList

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

Retornar valor

Se o driver não encontrar erros, ele deverá retornar STATUS_SUCCESS (especificando ou não qualquer recurso de hardware necessário). 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 EvtDeviceResourceRequirementsQuery . 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 EvtDeviceResourceRequirementsQuery do driver de barramento para obter uma lista de requisitos de recursos para o dispositivo.

O driver deve preencher o objeto resource-requirements-list fornecido com configurações lógicas de recursos de hardware que permitirão que o dispositivo opere corretamente.

Para criar uma lista de requisitos de recursos, o driver chama métodos de objeto de lista de intervalos de recursos da estrutura, que adicionam descritores de recursos a configurações lógicas e métodos de objeto framework resource-requirements-list, que adicionam configurações lógicas à lista de requisitos de recursos.

Para obter mais informações sobre recursos de hardware e como criar listas de requisitos de recursos, consulte Recursos de hardware para drivers de Framework-Based.

Se um driver estiver em execução em uma versão do sistema operacional anterior ao Windows 7, um motorista de ônibus poderá usar EvtDeviceResourceRequirementsQuery para definir uma propriedade de dispositivo em um dispositivo filho antes de enumerar o filho.

Para definir uma propriedade de dispositivo no Windows 7 ou posterior, um motorista de ônibus pode fornecer uma rotina de pré-processamento para IRP_MN_DEVICE_ENUMERATED.

Requisitos

Confira também

EvtDeviceResourcesQuery