EVT_WDF_DEVICE_SURPRISE_REMOVAL função de retorno de chamada (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento de um driver EvtDeviceSurpriseRemoval executa todas as operações necessárias depois que um dispositivo foi removido inesperadamente do sistema ou depois que um driver relata que o dispositivo falhou.

Sintaxe

EVT_WDF_DEVICE_SURPRISE_REMOVAL EvtWdfDeviceSurpriseRemoval;

void EvtWdfDeviceSurpriseRemoval(
  [in] WDFDEVICE Device
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Valor de retorno

Nenhum

Observações

Para registrar uma função de retorno de chamada EvtDeviceSurpriseRemoval, um driver deve chamar WdfDeviceInitSetPnpPowerEventCallbacks.

A estrutura não sincroniza a função de retorno de chamada EvtDeviceSurpriseRemoval com outras funções de retorno de chamada de gerenciamento de energia e PnP. Para obter informações sobre como a estrutura sincroniza a execução das funções de retorno de chamada de evento de um driver, consulte Usandode Sincronização Automática.

Para obter mais informações sobre quando a estrutura chama essa função de retorno de chamada e para obter mais informações sobre problemas de sincronização, consulte Um usuário desconecta um dispositivo.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
IRQL	PASSIVE_LEVEL

Compartilhar via