EVT_WDF_IO_TARGET_QUERY_REMOVE fonction de rappel (wdfiotarget.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtIoTargetQueryRemove d’un pilote indique si l’infrastructure peut supprimer en toute sécurité l’appareil d’une cible d’E/S distante spécifiée.

Syntaxe

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

NTSTATUS EvtWdfIoTargetQueryRemove(
  [in] WDFIOTARGET IoTarget
)
{...}

Paramètres

[in] IoTarget

Handle vers un objet cible d’E/S.

Valeur retournée

La fonction de rappelEvtIoTargetQueryRemove doit retourner STATUS_SUCCESS si le pilote détermine que le framework peut supprimer en toute sécurité le périphérique de la cible d’E/S spécifiée. Sinon, cette fonction de rappel doit retourner STATUS_UNSUCCESSFUL.

Remarques

Si la fonction de rappel EvtIoTargetQueryRemove d’un pilote retourne STATUS_SUCCESS, le système autorise la suppression du périphérique de la cible d’E/S, sauf si un autre pilote retourne STATUS_UNSUCCESSFUL.

Pour inscrire une fonction de rappel EvtIoTargetQueryRemove , placez l’adresse de la fonction de rappel dans la structure WDF_IO_TARGET_OPEN_PARAMS de la cible d’E /S. La fonction de rappel EvtIoTargetQueryRemove est facultative. Ne pas fournir cette fonction de rappel équivaut à retourner STATUS_SUCCESS.

La fonction de rappel EvtIoTargetQueryRemove doit appeler WdfIoTargetCloseForQueryRemove, si le pilote détermine que le gestionnaire PnP peut supprimer l’appareil cible en toute sécurité.

La fonction de rappel doit désactiver la capacité du pilote à envoyer des demandes d’E/S supplémentaires à la cible d’E/S.

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