EVT_WDF_DEVICE_EJECT función de devolución de llamada (wdfpdo.h)

  • Artículo

[Solo se aplica a KMDF]

La función de devolución de llamada de eventos EvtDeviceEject de un controlador controla las operaciones necesarias para expulsar un dispositivo de su estación de acoplamiento.

Sintaxis

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

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

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

Valor devuelto

Si la operación se realiza correctamente, el controlador debe devolver STATUS_SUCCESS. De lo contrario, debe devolver un valor NTSTATUS que NT_SUCCESS se evalúa como FALSE. No devuelva STATUS_NOT_SUPPORTED.

Para obtener más información sobre los valores devueltos, consulte Informes de errores de dispositivo.

Comentarios

Los controladores de bus basados en marco pueden proporcionar una función de devolución de llamada EvtDeviceEject . Un controlador de autobús debe proporcionar una función de devolución de llamada EvtDeviceEject si el controlador debe realizar operaciones que expulsen físicamente uno de sus dispositivos secundarios enumerados de la estación de acoplamiento del dispositivo. Para registrar esta función de devolución de llamada, el controlador de bus debe llamar a WdfPdoInitSetEventCallbacks.

Antes de llamar a la función de devolución de llamada EvtDeviceEject , el marco llama a las funciones de devolución de llamada EvtDeviceD0Exit y EvtDeviceReleaseHardware del controlador.

Si la función de devolución de llamada EvtDeviceEject de un controlador devuelve STATUS_SUCCESS, el marco actualiza la lista secundaria del controlador para indicar que el dispositivo expulsado ya no está disponible. Por lo tanto, el controlador no tiene que llamar a WdfPdoMarkMissing o WdfChildListUpdateChildDescriptionAsMissing.

Para obtener más información sobre la expulsión de dispositivos, consulte Compatibilidad con dispositivos expulsables.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfpdo.h (incluya Wdf.h)
IRQL PASSIVE_LEVEL

Consulte también

EvtDeviceSetLock