IWDFDevice2::CreateRemoteTarget-Methode (wudfddi.h)
[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 |
|---|---|
|
Fehler beim Versuch des Frameworks, Arbeitsspeicher zuzuweisen. |
|
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 |