IWDFDevice2 ::CreateRemoteTarget, méthode (wudfddi.h)
[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 CreateRemoteTarget crée un objet cible distant qui représente un cible d’E/S distante.
HRESULT CreateRemoteTarget(
[in, optional] IUnknown *pCallbackInterface,
[in, optional] IWDFObject *pParentObject,
[out] IWDFRemoteTarget **ppRemoteTarget
);
[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 est 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.
CreateRemoteTarget retourne S_OK si l’opération réussit. Sinon, la méthode peut retourner la valeur suivante :
| Retourner le code | Description |
|---|---|
|
Échec de la tentative de l’infrastructure d’allouer de la mémoire. |
|
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.
Une fois que votre pilote a appelé CreateRemoteTarget, le pilote peut ouvrir la cible distante en appelant IWDFRemoteTarget ::OpenRemoteInterface (pour ouvrir une d’interface d’appareil) 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 d’un objet dont la chaîne de parents mène à cet objet d’appareil. L’infrastructure supprime l’objet cible distant lorsqu’il (ou le pilote) supprime l’objet d’appareil.
Pour plus d’informations sur les cibles d’E/S distantes, consultez Utilisation des cibles d’E/S dans UMDF.
Pour obtenir des exemples de code qui utilisent CreateRemoteTarget, consultez les exemples de code à IWDFDevice2 ::CreateRemoteInterface et IWDFRemoteTarget ::OpenFileByName.
| 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 |