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

Programmierverzeichnis