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

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDeviceRemoveAddedResources de um driver remove os recursos de hardware adicionados pela função de retorno de chamada EvtDeviceFilterAddResourceRequirements do driver.

Sintaxe

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

NTSTATUS EvtWdfDeviceRemoveAddedResources(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST ResourcesRaw,
  [in] WDFCMRESLIST ResourcesTranslated
)
{...}

Parâmetros

[in] Device

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

[in] ResourcesRaw

Um identificador para um objeto de lista de recursos que identifica os recursos brutos de hardware atribuídos pelo gerenciador PnP ao dispositivo.

[in] ResourcesTranslated

Um identificador para um objeto de lista de recursos que identifica os recursos de hardware traduzidos que o gerenciador PnP atribuiu ao 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 EvtDeviceRemoveAddedResources . Para registrar essa função de retorno de chamada, os drivers chamam WdfFdoInitSetEventCallbacks.

Se um driver fornecer uma função de retorno de chamada EvtDeviceFilterAddResourceRequirements que adiciona recursos à lista de requisitos de hardware de um dispositivo, o driver também deve fornecer uma função de retorno de chamada EvtDeviceRemoveAddedResources . A função de retorno de chamada EvtDeviceRemoveAddedResources examina a lista de recursos que o gerenciador PnP atribuiu ao dispositivo e remove os recursos da lista que a função de retorno de chamada EvtDeviceFilterAddResourceRequirements adicionou. Se o driver remover um recurso, ele deverá removê-lo das listas de recursos brutos e traduzidos.

Para obter mais informações sobre listas de recursos e a ordem em que os recursos aparecem, consulte recursos de hardware brutos e traduzidos.

A estrutura chama a função de retorno de chamada EvtDeviceRemoveAddedResources do driver imediatamente antes de passar a lista de recursos do dispositivo para o driver de ônibus. Essa função de retorno de chamada remove recursos adicionados para que o motorista do barramento não tente usá-los.

Para obter mais informações sobre a função de retorno de chamada EvtDeviceRemoveAddedResources , consulte Modificando uma lista de recursos.

Para obter mais informações sobre recursos de hardware, 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	wdffdo.h (inclua Wdf.h)
IRQL	PASSIVE_LEVEL

Confira também

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements