Méthode IWDFDevice2 ::CreateRemoteTarget (wudfddi.h)
[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 |
|---|---|
|
La tentative d’allocation de mémoire de l’infrastructure a échoué. |
|
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 |