Partilhar via


EVT_WDF_DEVICE_EJECT função de retorno de chamada (wdfpdo.h)

[Aplica-se somente ao KMDF]

O de um driver EvtDeviceEject função de retorno de chamada de evento manipula operações necessárias para ejetar um dispositivo de sua estação de encaixe.

Sintaxe

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

NTSTATUS EvtWdfDeviceEject(
  [in] WDFDEVICE Device
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Valor de retorno

Se a operação for bem-sucedida, o driver deverá retornar STATUS_SUCCESS. Caso contrário, ele deverá retornar um valor NTSTATUS que NT_SUCCESS avaliado como FALSE. Não retorne STATUS_NOT_SUPPORTED.

Para obter mais informações sobre valores retornados, consulte de Relatório de Falhas de Dispositivo.

Observações

Os drivers de barramento baseados em estrutura podem fornecer uma função EvtDeviceEject de retorno de chamada. Um motorista de ônibus deve fornecer uma função EvtDeviceEject retorno de chamada se o driver precisar executar operações que ejetem fisicamente um de seus dispositivos filho enumerados da estação de encaixe do dispositivo. Para registrar essa função de retorno de chamada, o motorista do barramento deve chamar WdfPdoInitSetEventCallbacks.

Antes de chamar a função de retorno de chamada EvtDeviceEject, a estrutura chama as funções de retorno de chamada EvtDeviceD0Exit do driver e EvtDeviceReleaseHardware funções de retorno de chamada.

Se a função de retorno de chamada EvtDeviceEject de um driver retornar STATUS_SUCCESS, a estrutura atualizará a lista filho do driver para indicar que o dispositivo ejetado não está mais disponível. Portanto, o driver não precisa chamar WdfPdoMarkMissing ou WdfChildListUpdateChildDescriptionAsMissing.

Para obter mais informações sobre a ejeção do dispositivo, consulte Suporte a dispositivos ejetáveis.

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

Consulte também

EvtDeviceSetLock