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

Article
02/07/2025

[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 Rouvrez rouvrez une cible d’E/S distante une fois qu’elle a été temporairement fermée.

Syntaxe

HRESULT Reopen();

Valeur de retour

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

Retourner le code	Description
E_OUTOFMEMORY	Échec de la tentative de l’infrastructure d’allouer de la mémoire.

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 rouvrez à partir de l'IRemoteTargetCallbackRemoval ::OnRemoteTargetRemoveCanceled fonction de rappel, mais rouvrez pouvez à la place être appelée après OnRemoteTargetRemoveCanceled renvoie.

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

Pour plus d’informations sur rouvrir et comment utiliser des cibles d’E/S distantes dans des 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();
    }
}

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

Voir aussi

IWDFRemoteTarget

IWDFRemoteTarget ::Close

Partager via