IWDFRemoteTarget ::Close, 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 Close ferme un cible d’E/S distante.
Syntaxe
HRESULT Close();
Valeur de retour
La méthode Close retourne toujours S_OK.
Remarques
Si votre pilote fournit une fonction de rappel IRemoteTargetCallbackRemoval ::OnRemoteTargetRemoveComplete fonction de rappel, la fonction de rappel doit appeler Close.
La méthode close se termine ou annule toutes les demandes d’E/S envoyées par le pilote à la cible d’E/S.
Une fois qu’un pilote appelle Fermer, le pilote ne peut pas envoyer de requêtes d’E/S à la cible d’E/S.
Pour plus d’informations sur la méthode Close, 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 ::OnRemoteTargetRemoveComplete qui appelle Close.
VOID
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveComplete(
__in IWDFRemoteTarget *FxTarget
)
{
//
// Here, do any driver-specific actions that your driver requires
// to close the remote I/O target.
//
...
//
// Close the target.
//
FxTarget->Close();
}
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 |