EVT_WDF_DEVICE_EJECT função de retorno de chamada (wdfpdo.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada de evento EvtDeviceEject de um driver lida com 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.
Retornar valor
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 Relatando falhas de dispositivo.
Comentários
Os drivers de barramento baseados em estrutura podem fornecer uma função de retorno de chamada EvtDeviceEject . Um driver de ônibus deve fornecer uma função de retorno de chamada EvtDeviceEject 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 driver de 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 e EvtDeviceReleaseHardware do driver.
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 |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfpdo.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |