Freigeben über


Schnittstellen für Anwendungen

In diesem Abschnitt werden Schnittstellen beschrieben, die von Anwendungen mithilfe des Windows Media Geräte-Manager SDK für die Kommunikation mit Geräten verwendet oder implementiert werden. Der hier verwendete Begriff "Anwendung" bezeichnet alle ausführbaren Objekte, Plug-Ins oder COM-Objekte, die auf einem Desktopcomputer vorhanden sind und eine allgemeine Kommunikation mit einem verbundenen tragbaren Gerät benötigen. Dies kann eine Media Player-Anwendung, ein Windows Medienwiedergabe-Plug-In (wenn es direkten Zugriff auf ein tragbares Gerät benötigt) oder ein COM-Objekt zur Messung der Wiedergabeanzahl umfassen.

Einige dieser Schnittstellen werden von der Anwendung implementiert, während andere von der Anwendung aufgerufen werden. Die Dokumentation für jede Schnittstelle gibt an, ob sie implementiert oder aufgerufen wird (und ob sie implementiert ist, ob sie optional oder erforderlich ist).

Die folgenden Schnittstellen oder Klassen werden von Anwendungen verwendet.

Schnittstelle oder Klasse BESCHREIBUNG
CSecureChannelClient-Klasse Eine Hilfsklasse, die es Anwendungen ermöglicht, sich selbst zu authentifizieren, Daten zu verschlüsseln und zu entschlüsseln und MACs zu erstellen.
IWMDeviceManager Die Windows Media-Geräte-Manager-Schnittstelle der obersten Ebene für Anwendungen.
IWMDeviceManager2 Erweitert IWMDeviceManager , indem erweiterte Enumerationsmethoden und andere Methoden bereitgestellt werden.
IWMDeviceManager3 Erweitert die IWMDeviceManager2-Schnittstelle , indem eine -Methode bereitgestellt wird, die die Einstellung für die Geräteenumeration festlegt.
IWMDMGeräte Stellt Methoden bereit, um ein einzelnes tragbares Gerät zu untersuchen und zu untersuchen.
IWMDMDevice2 Erweitert IWMDMDevice , indem es ermöglicht, die von einem Gerät unterstützten Videoformate abzurufen, einen Speicher anhand des Namens zu suchen und Eigenschaftenseiten zu verwenden.
IWMDMDevice3 Erweitert IWMDMDevice2 durch Die Bereitstellung von Methoden zum Abfragen von Eigenschaften eines Geräts, zum Senden von Geräte-E/A-Steuerungscodes und zum Bereitstellen aktualisierter Methoden zum Suchen nach Speicher und Abrufen von Geräteformatfunktionen.
IWMDMDeviceControl Stellt Methoden zum Steuern von Geräten bereit.
IWMDMDeviceSession Verbessert die Effizienz von Gerätevorgängen, indem mehrere Vorgänge in einer Sitzung zusammengefasst werden.
IWMDMEnumDevice Listet tragbare Geräte auf, die an einen Computer angeschlossen sind.
IWMDMEnumStorage Listet Speicher auf einem Gerät auf.
IWMDMMetaData Legt Metadateneigenschaften (z. B. Interpret, Album, Genre usw.) eines Speichers fest und ruft sie ab.
IWMDMObjectInfo Ruft Informationen ab und legt sie fest, die steuern, wie abspielbare Dateien auf dem Gerät von der IWMDMDeviceControl-Schnittstelle behandelt werden.
IWMDMRevoked Ruft die URL ab, aus der aktualisierte Komponenten heruntergeladen werden können, wenn bei einer Übertragung ein Sperrfehler auftritt.
IWMDMStorage Stellt Methoden zum Untersuchen und Untersuchen eines Speichers (Datei, Ordner, Wiedergabeliste) auf einem Gerät bereit.
IWMDMStorage2 Erweitert IWMDMStorage , indem es ermöglicht, einen untergeordneten Speicher anhand des Namens abzurufen und erweiterte Attribute abzurufen und festzulegen.
IWMDMStorage3 Erweitert IWMDMStorage2 durch Verfügbarmachen von Metadaten.
IWMDMStorage4 Erweitert IWMDMStorage3 durch Die Bereitstellung von Methoden zum Abrufen einer Teilmenge der verfügbaren Metadaten für einen Speicher sowie zum Festlegen und Abrufen einer Liste von Verweisen auf andere Speicher.
IWMDMStorageControl Wird zum Einfügen, Löschen oder Verschieben von Dateien innerhalb eines Geräts oder zwischen einem Gerät und dem Computer verwendet.
IWMDMStorageControl2 Erweitert IWMDMStorageControl , indem beim Einfügen von Inhalten in einen Speicher der Name der Zieldatei festgelegt werden kann.
IWMDMStorageControl3 Erweitert IWMDMStorageControl2 , indem es ermöglicht, einen IWMDMMetaData-Schnittstellenzeiger zu übergeben.
IWMDMStorageGlobals Stellt Methoden zum Abrufen globaler Informationen zu einem Speichermedium (z. B. einem Flash-ROM-Karte) auf einem Gerät bereit.
IWMDRMDeviceApp Ermöglicht einer Anwendung das Durchführen der Messung, Lizenzsynchronisierung und Aktualisierung der DRM-Komponenten eines Geräts.
IWMDRMDeviceApp2 Erweitert IWMDRMDeviceApp , indem eine neue Version der QueryDeviceStatus-Methode bereitgestellt wird.

 

Rückrufschnittstellen

Die folgenden optionalen Schnittstellen werden von einer Anwendung implementiert, um den Fortschritt einer asynchronen Anforderung, z. B. einer Lese- oder Schreibanforderung, nachzuverfolgen.

Schnittstelle BESCHREIBUNG
IWMDMNotification Ermöglicht Anwendungen und Dienstanbietern das Empfangen von Benachrichtigungen, wenn Geräte oder Speicherspeicher (z. B. RAM-Karten) mit dem Computer verbunden oder getrennt sind.
IWMDMOperation2 Erweitert IWMDMOperation durch Die Bereitstellung von Methoden zum Abrufen und Festlegen erweiterter Attribute.
IWMDMOperation3 Erweitert IWMDMOperation , indem eine neue Methode für die unverschlüsselte Übertragung von Daten bereitgestellt wird, um die Effizienz zu erhöhen.
IWMDMOperation Ermöglicht einer Anwendung, zu steuern, wie Daten während einer Dateiübertragung vom Computer gelesen oder auf diesen geschrieben werden.
IWMDMProgress2 Erweitert die IWMDMProgress::End-Methode, indem ein status-Indikator bereitgestellt wird.
IWMDMProgress3 Erweitert IWMDMProgress2 , indem zusätzliche Eingabeparameter bereitgestellt werden, um die Ereignis-ID und kontextspezifische Informationen anzugeben.
IWMDMProgress Ermöglicht einer Anwendung das Nachverfolgen des Fortschritts von Vorgängen, z. B. formatieren von Medien oder Dateiübertragungen.

 

Das folgende Diagramm zeigt, wie die meisten wichtigen Anwendungsschnittstellen von der IWMDeviceManager-Stammschnittstelle abgerufen werden. Eine Anwendung ruft diese Stammschnittstelle ab, indem sie das MediaDevMgr-Objekt erstellt, die IComponentAuthenticate-Schnittstelle anfordert, die Komponente authentifiziert und dann den IWMDeviceManager anfordert (diese Schritte werden unter Authentifizieren der Anwendung beschrieben). Nachdem diese Stammschnittstelle abgerufen wurde, wird IWMDeviceManager::EnumDevices aufgerufen, um ein Objekt zu erstellen, das IWMDMEnumDevice implementiert. Andere Schnittstellen werden durch Aufrufen von Methoden für Schnittstellen in der angezeigten Reihenfolge abgerufen. Abgeleitete Schnittstellen wie IWMDMDevice2 werden durch Aufrufen von QueryInterface auf der Basisschnittstelle abgerufen.

Im folgenden Diagramm sind abgeleitete Schnittstellen durch Schrägstriche gekennzeichnet, sodass "IWMDMMStorage/2/3" IWMDMStorage, IWMDMStorage2 und IWMDMStorage3 angeben würde.

Diagramm, das zeigt, wie Die wichtigsten Anwendungsschnittstellen im Windows Media Device Manager abgerufen werden.

Programmierverzeichnis