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 |