EVT_WDF_DEVICE_EJECT fonction de rappel (wdfpdo.h)

[S’applique à KMDF uniquement]

La fonction de rappel d’événement EvtDeviceEject d’un pilote gère les opérations nécessaires pour éjecter un appareil de sa station d’accueil.

Syntaxe

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

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

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

Valeur retournée

Si l’opération réussit, le pilote doit retourner STATUS_SUCCESS. Sinon, elle doit retourner une valeur NTSTATUS qui NT_SUCCESS a la valeur FALSE. Ne retournez pas STATUS_NOT_SUPPORTED.

Pour plus d’informations sur les valeurs de retour, consultez Signalement des défaillances d’appareils.

Remarques

Les pilotes de bus basés sur l’infrastructure peuvent fournir une fonction de rappel EvtDeviceEject . 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’accueil 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 EvtDeviceD0Exit et EvtDeviceReleaseHardware du pilote.

Si la fonction de rappel EvtDeviceEject d’un pilote retourne STATUS_SUCCESS, l’infrastructure met à jour la liste enfant du pilote pour indiquer que le périphérique é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 des appareils, consultez Prise en charge des appareils éjectables.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfpdo.h (inclure Wdf.h)
IRQL	PASSIVE_LEVEL

Voir aussi

EvtDeviceSetLock