IPortableDevice-Schnittstelle (portabledeviceapi.h)

Die IPortableDevice-Schnittstelle ermöglicht den Zugriff auf ein tragbares Gerät.

Um diese Schnittstelle zu erstellen und zu öffnen, rufen Sie zuerst CoCreateInstance mit CLSID_PortableDeviceFTM oder CLSID_PortableDevice auf, um eine IPortableDevice-Schnittstelle abzurufen, und rufen Sie dann Open auf, um eine Verbindung mit dem Gerät zu öffnen.

Vererbung

Die IPortableDevice-Schnittstelle erbt von der IUnknown-Schnittstelle . IPortableDevice verfügt auch über die folgenden Typen von Membern:

Methoden

Die IPortableDevice-Schnittstelle verfügt über diese Methoden.

IPortableDevice::Advise Die Advise-Methode registriert einen anwendungsdefinierten Rückruf, der Geräteereignisse empfängt.
IPortableDevice::Cancel Die Cancel-Methode bricht einen ausstehenden Vorgang für diese Schnittstelle ab.
IPortableDevice::Capabilities Die Capabilities-Methode ruft eine Schnittstelle ab, die zum Abfragen der Funktionen eines tragbaren Geräts verwendet wird.
IPortableDevice::Close Die Close-Methode schließt die Verbindung mit dem Gerät.
IPortableDevice::Content Die Content-Methode ruft eine Schnittstelle ab, die Sie für den Zugriff auf Objekte auf einem Gerät verwenden können.
IPortableDevice::GetPnPDeviceID Die GetPnPDeviceID-Methode ruft den PnP-Gerätebezeichner (Plug and Play) ab, den die Anwendung zum Öffnen des Geräts verwendet hat.
IPortableDevice::Open Die Open-Methode öffnet eine Verbindung zwischen der Anwendung und dem Gerät.
IPortableDevice::SendCommand Die SendCommand-Methode sendet einen Befehl an das Gerät und ruft die Ergebnisse synchron ab.
IPortableDevice::Unadvise Die Methode Unadvise hebt die Registrierung eines Clients vom Empfangen von Rückrufbenachrichtigungen auf. Sie müssen diese Methode aufrufen, wenn Sie Zuvor Advise aufgerufen haben.

Hinweise

Die Clientschnittstellen sind so konzipiert, dass sie für jedes WPD-Objekt verwendet werden können. Es ist nicht erforderlich, für jedes Objekt, auf das von der Anwendung verwiesen wird, eine neue instance zu erstellen. Nachdem eine Anwendung eine instance der IPortableDevice-Schnittstelle geöffnet hat, sollten alle anderen benötigten WPD-Clientschnittstellen geöffnet und zwischengespeichert werden.

Für Windows 7 unterstützt IPortableDevice zwei CLSIDs für CoCreateInstance. CLSID_PortableDevice gibt einen IPortableDevice-Zeiger zurück, der den Freethread-Marshaller nicht aggregiert. CLSID_PortableDeviceFTM ist eine neue CLSID, die einen IPortableDevice-Zeiger zurückgibt, der den Freethread-Marshaller aggregiert. Beide Zeiger unterstützen andernfalls dieselbe Funktionalität.

Anwendungen, die in Single Threaded Apartments leben, sollten CLSID_PortableDeviceFTM verwenden, da dadurch der Mehraufwand für das Marshallen von Schnittstellenzeigern entfällt. CLSID_PortableDevice wird weiterhin für Legacyanwendungen unterstützt.

Requirements (Anforderungen)

Zielplattform	Windows
Kopfzeile	portabledeviceapi.h

Weitere Informationen

Clientschnittstellen