EVT_WDF_IO_TARGET_QUERY_REMOVE fonction de rappel (wdfiotarget.h)
[S’applique à KMDF et UMDF]
La fonction de rappel d’événement evtIoTargetQueryRemove evtIoTargetQueryRemove 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 de retour
La fonction de rappelEvtIoTargetQueryRemove doit retourner STATUS_SUCCESS si le pilote détermine que l’infrastructure peut supprimer en toute sécurité l’appareil 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 du pilote retourne STATUS_SUCCESS, le système autorise la suppression de l’appareil 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 en toute sécurité l’appareil cible.
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.
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| En-tête | wdfiotarget.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |