função de retorno de chamada EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS (wdffdo.h)

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDeviceFilterAddResourceRequirements de um driver pode adicionar recursos a um conjunto de requisitos de recursos de hardware antes que o sistema atribua recursos a um dispositivo.

A função de retorno de chamada de evento EvtDeviceFilterRemoveResourceRequirements de um driver pode remover recursos de um conjunto de requisitos de recursos de hardware antes que o sistema atribua recursos a um dispositivo.

Sintaxe

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

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

Parâmetros

[in] Device

Um identificador para o objeto de dispositivo de estrutura ao qual os recursos serão atribuídos.

[in] IoResourceRequirementsList

Um identificador para um objeto resource-requirements-list, que representa a lista de requisitos de recursos do dispositivo.

Retornar valor

Se o driver não encontrou erros, ele deverá retornar STATUS_SUCCESS. Caso contrário, ele deverá retornar um valor NTSTATUS que NT_SUCCESS é avaliado como FALSE.

Para obter mais informações sobre valores retornados, consulte Relatando falhas de dispositivo.

Comentários

Os drivers de função baseados em estrutura podem fornecer uma função de retorno de chamada EvtDeviceFilterAddResourceRequirements e uma função de retorno de chamada EvtDeviceFilterRemoveResourceRequirements. Para registrar essas funções de retorno de chamada, os drivers chamam WdfFdoInitSetEventCallbacks.

Quando a estrutura chama a função de retorno de chamada EvtDeviceFilterAddResourceRequirements de um driver, o driver pode adicionar descritores de recursos a uma configuração lógica e pode fornecer configurações lógicas adicionais. Esses itens adicionados representam recursos que o driver de função requer para tornar o dispositivo operacional.

Se a função de retorno de chamada EvtDeviceFilterAddResourceRequirements de um driver adicionar itens à lista de requisitos de recursos de um dispositivo e, se o gerenciador PnP atribuir os recursos à lista de requisitos do dispositivo, a função de retorno de chamada EvtDeviceRemoveAddedResources do driver deverá remover os recursos adicionados da lista de recursos do dispositivo.

Para adicionar ou remover itens de uma lista de requisitos de recursos, o driver chama métodos de objeto framework resource-requirements-list e métodos de objeto framework resource-range-list, que manipula o objeto resource-requirements-list representado pelo parâmetro IoResourceRequirementsList .

Para obter mais informações sobre essas funções de retorno de chamada, consulte Modificando uma lista de requisitos de recursos.

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

Para obter informações sobre como modificar recursos de interrupção (por exemplo, afinidade de processador), consulte a seção Comentários de WdfInterruptSetPolicy.

Requisitos

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

Confira também

EvtDeviceRemoveAddedResources