Méthode IWDFRemoteTarget ::Reopen (wudfddi.h)

Article
03/01/2024

[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 Reopen rouvre une cible d’E/S distante après sa fermeture temporaire.

Syntaxe

HRESULT Reopen();

Valeur de retour

La réouverture retourne S_OK si l’opération réussit. Sinon, la méthode peut retourner la valeur suivante :

Code de retour	Description
E_OUTOFMEMORY	La tentative d’allocation de mémoire de l’infrastructure a échoué.

Cette méthode peut retourner l’une des autres valeurs que Winerror.h contient.

Le vérificateur de l’infrastructure signale une erreur si l’infrastructure ne peut pas ouvrir le fichier.

Remarques

En règle générale, un pilote appelle Rouvrir à partir de la fonction de rappel IRemoteTargetCallbackRemoval ::OnRemoteTargetRemoveCanceled , mais Rouvert peut être appelé après les retours de OnRemoteTargetRemoveCanceled .

Rouvrez utilise le nom de fichier ou d’interface que le pilote a précédemment spécifié sur IWDFRemoteTarget ::OpenFileByName ou IWDFRemoteTarget ::OpenRemoteInterface. Si vous souhaitez modifier le fichier ou l’interface que le pilote utilise, celui-ci peut appeler IWDFRemoteTarget ::Close, puis appeler OpenFileByName ou OpenRemoteInterface au lieu de Rouvrir.

Pour plus d’informations sur la réouverture et sur l’utilisation des cibles d’E/S distantes dans les pilotes basés sur UMDF, 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 ::OnRemoteTargetRemoveCanceled qui appelle Rouvrir.

VOID 
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveCanceled(
    __in IWDFRemoteTarget* FxTarget
    )
{
 if (S_OK == (FxTarget->Reopen()))
    {
    //
    // Resume sending I/O requests to the remote target.
    //
    ...
    }
 else
    {
       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 ::Close

Partager via