Partager via

IWDFRemoteTarget ::Close, méthode (wudfddi.h)

  • Article

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode Close ferme une 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 , la fonction de rappel doit appeler Close.

La méthode Close termine ou annule toutes les demandes d’E/S que le pilote a envoyées à la cible d’E/S.

Après qu’un pilote a appelé Close, le pilote ne peut pas envoyer de demandes 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();
}

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1,9
En-tête wudfddi.h (inclure Wudfddi.h)
DLL WUDFx.dll

Voir aussi

IWDFRemoteTarget

IWDFRemoteTarget ::CloseForQueryRemove