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

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDeviceRemoveAddedResources do driver remove os recursos de hardware que o driver EvtDeviceFilterAddResourceRequirements função de retorno de chamada adicionada.

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 do 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 que o gerenciador PnP atribuiu ao dispositivo.

[in] ResourcesTranslated

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

Valor de retorno

Se o driver não tiver encontrado 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 de Relatório de Falhas de Dispositivo.

Observações

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 um EvtDeviceRemoveAddedResources função de retorno de chamada. 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 o EvtDeviceFilterAddResourceRequirements função de retorno de chamada adicionada. 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 o do driver EvtDeviceRemoveAddedResources função de retorno de chamada imediatamente antes de passar a lista de recursos do dispositivo para o driver de ônibus. Essa função de retorno de chamada remove os recursos adicionados para que o motorista do ônibus 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

Consulte também

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements