IWDFDevice2::CreateRemoteTarget-Methode (wudfddi.h)

  • Artikel

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die CreateRemoteTarget-Methode erstellt ein Remotezielobjekt, das ein Remote-E/A-Ziel darstellt.

Syntax

HRESULT CreateRemoteTarget(
  [in, optional] IUnknown         *pCallbackInterface,
  [in, optional] IWDFObject       *pParentObject,
  [out]          IWDFRemoteTarget **ppRemoteTarget
);

Parameter

[in, optional] pCallbackInterface

Ein Zeiger auf eine optionale, vom Treiber bereitgestellte Rückrufschnittstelle. Die IUnknown::QueryInterface-Methode dieser Schnittstelle muss einen Zeiger auf die IRemoteTargetCallbackRemoval-Schnittstelle des Treibers zurückgeben, wenn der Treiber diese Schnittstelle unterstützt. Dieser Parameter ist optional und kann NULL sein.

[in, optional] pParentObject

Ein Zeiger auf ein Frameworkobjekt. Wenn der Treiber diesen optionalen Zeiger bereitstellt, wird das angegebene Objekt das übergeordnete Objekt des neuen Remotezielobjekts. Wenn dieser Parameter NULL ist, wird das Geräteobjekt, das die IWDFDevice2-Schnittstelle bereitstellt, zum übergeordneten Objekt. Das Framework löscht das Remotezielobjekt, wenn es das übergeordnete Objekt löscht.

[out] ppRemoteTarget

Ein Zeiger auf eine Position, die einen Zeiger auf die IWDFRemoteTarget-Schnittstelle des neuen Remotezielobjekts empfängt.

Rückgabewert

CreateRemoteTarget gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Methode möglicherweise den folgenden Wert zurück:

Rückgabecode Beschreibung
E_OUTOFMEMORY
 Fehler beim Versuch des Frameworks, Arbeitsspeicher zuzuweisen.
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)
 Der pParentObject-Parameter hat nicht das Geräteobjekt angegeben, das die IWDFDevice2-Schnittstelle bereitstellt, oder ein Objekt, dessen Kette von übergeordneten Elementen zu diesem Objekt führt.
 

Diese Methode gibt möglicherweise einen der anderen Werte zurück, die Winerror.h enthält.

Hinweise

Nachdem Ihr Treiber CreateRemoteTarget aufgerufen hat, kann der Treiber das Remoteziel öffnen, indem er entweder IWDFRemoteTarget::OpenRemoteInterface (zum Öffnen einer Geräteschnittstelle) oder IWDFRemoteTarget::OpenFileByName (zum Öffnen einer Datei) aufruft.

Wenn der Treiber den pParentObject-Parameter verwendet, um ein übergeordnetes Objekt anzugeben, kann das übergeordnete Objekt das Geräteobjekt sein, das die IWDFDevice2-Schnittstelle bereitstellt, oder es kann sich um ein beliebiges Objekt handeln, dessen Kette von übergeordneten Elementen zu diesem Geräteobjekt führt. Das Framework löscht das Remotezielobjekt, wenn es (oder der Treiber) das Geräteobjekt löscht.

Weitere Informationen zu Remote-E/A-Zielen finden Sie unter Verwenden von E/A-Zielen in UMDF.

Beispiele

Codebeispiele, die CreateRemoteTarget verwenden, finden Sie in den Codebeispielen unter IWDFDevice2::CreateRemoteInterface und IWDFRemoteTarget::OpenFileByName.

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform Desktop
UMDF-Mindestversion 1.9
Kopfzeile wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Weitere Informationen

IWDFDevice2

IWDFRemoteTarget::OpenFileByName

IWDFRemoteTarget::OpenRemoteInterface