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

Confira também

EvtDeviceSetLock