EVT_WDF_IO_TARGET_REMOVE_COMPLETE fonction de rappel (wdfiotarget.h)

Article
08/08/2023

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtIoTargetRemoveComplete d’un pilote effectue des opérations lorsque la suppression d’une cible d’E/S distante spécifiée est terminée.

Syntaxe

EVT_WDF_IO_TARGET_REMOVE_COMPLETE EvtWdfIoTargetRemoveComplete;

void EvtWdfIoTargetRemoveComplete(
  [in] WDFIOTARGET IoTarget
)
{...}

Paramètres

[in] IoTarget

Handle vers un objet cible d’E/S.

Valeur de retour

None

Remarques

Pour inscrire une fonction de rappel EvtIoTargetRemoveComplete , placez l’adresse de la fonction de rappel dans la structure WDF_IO_TARGET_OPEN_PARAMS de la cible d’E /S.

L’infrastructure appelle la fonction de rappel EvtIoTargetRemoveComplete de votre pilote après que la fonction de rappel EvtIoTargetQueryRemove du pilote retourne STATUS_SUCCESS, ou après la suppression inattendue de l’appareil (suppression surprise).

La fonction de rappel EvtIoTargetRemoveComplete d’un pilote doit fermer définitivement la cible d’E/S distante en appelant WdfIoTargetClose. Étant donné que l’appareil cible a été supprimé, la fonction de rappel EvtIoTargetRemoveComplete doit également effectuer toutes les opérations de suppression de cible supplémentaires qui peuvent être nécessaires, telles que la libération des ressources système que le pilote a allouées lors de l’ouverture de la cible.

La fonction de rappel EvtIoTargetRemoveComplete est facultative. Si le pilote ne fournit pas cette fonction de rappel, l’infrastructure ferme définitivement la cible d’E/S.

Pour plus d’informations sur la fonction de rappel EvtIoTargetRemoveComplete , consultez Contrôle de l’état d’une cible d’E/S générale.