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 info, vedi Introduzione con 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 IRemoteTargetCallbackRemoval 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 IWDFDevice2 diventa l'elemento padre. Il framework eliminerà l'oggetto di destinazione remota quando elimina l'oggetto padre.
[out] ppRemoteTarget
Puntatore a una posizione che riceve un puntatore all'interfaccia IWDFRemoteTarget 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 ha specificato 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 da Winerror.h.
Commenti
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 usa 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 Uso delle destinazioni di I/O in UMDF.
Esempio
Per esempi di codice che usano CreateRemoteTarget, vedere gli esempi di codice in IWDFDevice2::CreateRemoteInterface e IWDFRemoteTarget::OpenFileByName.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1,9 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |