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.
Zugehörige Themen