IWDFRemoteTarget ::CloseForQueryRemove, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode CloseForQueryRemove ferme une cible d’E/S distante, car le système d’exploitation peut autoriser la suppression de l’appareil.
Syntaxe
HRESULT CloseForQueryRemove();
Valeur de retour
La méthode CloseForQueryRemove retourne toujours S_OK.
Remarques
Si votre pilote fournit une fonction de rappel IRemoteTargetCallbackRemoval ::OnRemoteTargetQueryRemove fonction de rappel, la fonction de rappel doit appeler CloseForQueryRemove si elle retourne TRUE pour indiquer que l’appareil peut être supprimé.
La méthode CloseForQueryRemove termine ou annule toutes les requêtes d’E/S envoyées par le pilote à la cible d’E/S.
Une fois qu’un pilote appelle CloseForQueryRemove, le pilote ne peut pas envoyer de requêtes d’E/S à la cible d’E/S jusqu’à ce qu’il appelle IWDFRemoteTarget ::Rouvrez.
Pour plus d’informations sur la méthode CloseForQueryRemove, consultez Contrôle de l’état d’une cible d’E/S générale dans UMDF.
Exemples
L’exemple de code suivant montre une fonction de rappel IRemoteTargetCallbackRemoval ::OnRemoteTargetQueryRemove fonction de rappel qui appelle CloseForQueryRemove.
BOOL
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetQueryRemove(
__in IWDFRemoteTarget *FxTarget
)
{
//
// Here, do any driver-specific actions that your driver requires
// to stop sending I/O requests to the I/O target.
//
...
//
// Close the target.
//
FxTarget->CloseForQueryRemove();
//
// Return TRUE if you want to allow removal of the device.
//
return TRUE;
}
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.9 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |