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 ônibus cria uma lista de requisitos de recurso 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.
Valor de retorno
Se o driver não tiver encontrado 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.
Observações
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 motoristas de barramento chamam WdfPdoInitSetEventCallbacks.
A estrutura chama a função de retorno de chamada do driver de barramento EvtDeviceResourceRequirementsQuery para obter uma lista de requisitos de recursos para o dispositivo.
O driver deve preencher o objeto de lista de requisitos de recurso 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 recursos da estrutura, que adicionam descritores de recursos a configurações lógicas e métodos de objeto de lista de requisitos de recursos da estrutura, que adicionam configurações lógicas à lista de requisitos de recursos.
Para obter mais informações sobre recursos de hardware e 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
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfpdo.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL |