Metodo IWDFDevice2::CreateRemoteTarget (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Il metodo CreateRemoteTarget crea un oggetto di destinazione remoto che rappresenta una destinazione di I/O remota .
Sintassi
HRESULT CreateRemoteTarget(
[in, optional] IUnknown *pCallbackInterface,
[in, optional] IWDFObject *pParentObject,
[out] IWDFRemoteTarget **ppRemoteTarget
);
Parametri
[in, optional] pCallbackInterface
Puntatore a un'interfaccia di callback fornita dal driver facoltativa. Il metodo IUnknown::QueryInterface di questa interfaccia deve restituire un puntatore all'interfaccia IRemoteTargetCallbackRemo val del driver, se il driver supporta tale interfaccia. Questo parametro è facoltativo e può essere NULL.
[in, optional] pParentObject
Puntatore a un oggetto framework. Se il driver fornisce questo puntatore facoltativo, l'oggetto specificato diventa l'elemento padre del nuovo oggetto di destinazione remoto. Se questo parametro è NULL, l'oggetto dispositivo che fornisce l'interfaccia IWDFDevice 2 diventa l'interfaccia padre. Il framework eliminerà l'oggetto di destinazione remoto quando elimina l'oggetto padre.
[out] ppRemoteTarget
Puntatore a una posizione che riceve un puntatore al IWDFRemoteTarget interfaccia del nuovo oggetto di destinazione remota.
Valore restituito
CreateRemoteTarget restituisce S_OK se l'operazione ha esito positivo. In caso contrario, il metodo potrebbe restituire il valore seguente:
| Codice restituito | Descrizione |
|---|---|
|
Il tentativo del framework di allocare memoria non è riuscito. |
|
Il parametro pParentObject non specifica l'oggetto dispositivo che fornisce l'interfaccia IWDFDevice2 o un oggetto la cui catena di elementi padre conduce a tale oggetto. |
Questo metodo potrebbe restituire uno degli altri valori contenuti in Winerror.h.
Osservazioni
Dopo che il driver ha chiamato CreateRemoteTarget, il driver può aprire la destinazione remota chiamando IWDFRemoteTarget::OpenRemoteInterface (per aprire un'interfaccia del dispositivo ) o IWDFRemoteTarget::OpenFileByName (per aprire un file).
Se il driver utilizza il parametro pParentObject per specificare un oggetto padre, l'oggetto padre può essere l'oggetto dispositivo che fornisce l'interfaccia IWDFDevice2 oppure può essere qualsiasi oggetto la cui catena di elementi padre conduce a tale oggetto dispositivo. Il framework eliminerà l'oggetto di destinazione remota quando (o il driver) eliminerà l'oggetto dispositivo.
Per altre informazioni sulle destinazioni di I/O remote, vedere Using I/O Targets in UMDF.
Esempi
Per esempi di codice che usano CreateRemoteTarget, vedere gli esempi di codice in IWDFDevice2::CreateRemoteInterface e IWDFRemoteTarget::OpenFileByName.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.9 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |