EVT_WDF_DEVICE_EJECT fonction de rappel (wdfpdo.h)

[S’applique uniquement à KMDF]

La fonction de rappel d’événement evtDeviceEject evtDeviceEject gère les opérations nécessaires à l’éjection d’un appareil à partir de sa station d’ancrage.

Syntaxe

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

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

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

Valeur de retour

Si l’opération réussit, le pilote doit retourner STATUS_SUCCESS. Sinon, il doit retourner une valeur NTSTATUS qui NT_SUCCESS est évaluée comme FALSE. Ne retournez pas STATUS_NOT_SUPPORTED.

Pour plus d’informations sur les valeurs de retour, consultez Reporting Device Failures.

Remarques

Les pilotes de bus basés sur le framework peuvent fournir une fonction de rappel EvtDeviceEjecteject. Un pilote de bus doit fournir une fonction de rappel EvtDeviceEject si le pilote doit effectuer des opérations qui éjectent physiquement l’un de ses appareils enfants énumérés à partir de la station d’ancrage de l’appareil. Pour inscrire cette fonction de rappel, le pilote de bus doit appeler WdfPdoInitSetEventCallbacks.

Avant d’appeler la fonction de rappel EvtDeviceEject, l’infrastructure appelle les fonctions de rappel EvtDeviceD0Ex it du pilote et EvtDeviceReleaseHardware fonctions de rappel.

Si la fonction de rappel EvtDeviceEject pilote retourne STATUS_SUCCESS, l’infrastructure met à jour la liste enfant du pilote pour indiquer que l’appareil éjecté n’est plus disponible. Par conséquent, le pilote n’a pas besoin d’appeler WdfPdoMarkMissing ou WdfChildListUpdateChildDescriptionAsMissing.

Pour plus d’informations sur l’éjection d’appareil, consultez Prise en charge des appareils éjectables.

Spécifications

Voir aussi

EvtDeviceSetLock