Méthode IWDFDevice2 ::CreateRemoteTarget (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 CreateRemoteTarget crée un objet cible distant qui représente une cible d’E/S distante.

Syntaxe

HRESULT CreateRemoteTarget(
  [in, optional] IUnknown         *pCallbackInterface,
  [in, optional] IWDFObject       *pParentObject,
  [out]          IWDFRemoteTarget **ppRemoteTarget
);

Paramètres

[in, optional] pCallbackInterface

Pointeur vers une interface de rappel facultative fournie par le pilote. La méthode IUnknown ::QueryInterface de cette interface doit retourner un pointeur vers l’interface IRemoteTargetCallbackRemoval du pilote, si le pilote prend en charge cette interface. Ce paramètre est facultatif et peut être NULL.

[in, optional] pParentObject

Pointeur vers un objet framework. Si le pilote fournit ce pointeur facultatif, l’objet spécifié devient le parent du nouvel objet cible distant. Si ce paramètre a la valeur NULL, l’objet d’appareil qui fournit l’interface IWDFDevice2 devient le parent. L’infrastructure supprime l’objet cible distant lorsqu’il supprime l’objet parent.

[out] ppRemoteTarget

Pointeur vers un emplacement qui reçoit un pointeur vers l’interface IWDFRemoteTarget du nouvel objet cible distant.

Valeur retournée

CreateRemoteTarget 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é.
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)
 Le paramètre pParentObject n’a pas spécifié l’objet d’appareil qui fournit l’interface IWDFDevice2 ou un objet dont la chaîne de parents mène à cet objet.
 

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

Remarques

Une fois que votre pilote a appelé CreateRemoteTarget, il peut ouvrir la cible distante en appelant IWDFRemoteTarget ::OpenRemoteInterface (pour ouvrir une interface de périphérique) ou IWDFRemoteTarget ::OpenFileByName (pour ouvrir un fichier).

Si le pilote utilise le paramètre pParentObject pour spécifier un objet parent, l’objet parent peut être l’objet d’appareil qui fournit l’interface IWDFDevice2 , ou il peut s’agir de n’importe quel objet dont la chaîne de parents mène à cet objet d’appareil. L’infrastructure supprime l’objet cible distant lorsqu’elle (ou le pilote) supprime l’objet de périphérique.

Pour plus d’informations sur les cibles d’E/S distantes, consultez Utilisation de cibles d’E/S dans UMDF.

Exemples

Pour obtenir des exemples de code qui utilisent CreateRemoteTarget, consultez les exemples de code sur IWDFDevice2 ::CreateRemoteInterface et IWDFRemoteTarget ::OpenFileByName.

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

IWDFDevice2

IWDFRemoteTarget ::OpenFileByName

IWDFRemoteTarget ::OpenRemoteInterface