Metodo IWDFDevice2::CreateRemoteTarget (wudfddi.h)

  • Articolo

[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
E_OUTOFMEMORY
 Il tentativo del framework di allocare memoria non è riuscito.
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)
 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

Vedi anche

IWDFDevice2

IWDFRemoteTarget::OpenFileByName

IWDFRemoteTarget::OpenRemoteInterface