Anforderungen für die Anzeige von tragbaren Audioplayern in Windows Explorer
Die Namespaceerweiterung für portable Audioplayer-Shell bietet Windows-Benutzern eine konsistente Möglichkeit, Audiogeräte zu verwalten, die von Windows Media Geräte-Manager verwaltet werden. Wenn Sie Ihren Dienstanbieter und Ihre Treiberkomponenten gemäß den folgenden Richtlinien erstellen, wird Ihr Gerät im Shellnamespace angezeigt. Benutzer können in Windows Explorer auf konsistente Weise mit den Inhalten Ihres Geräts interagieren, um grundlegende Vorgänge wie Kopieren, Löschen und Umbenennen auszuführen.
Die folgenden Shellanforderungen für Dienstanbieter- und Treiberkomponenten sollen die allgemeinen Richtlinien für Windows Media Geräte-Manager ergänzen.
Gerätefunktionen
Windows Media-Geräte-Manager-Dienstanbieter sollten in ihren unterstützten Funktionen explizit sein. Wenn ein Aufruf nicht unterstützt wird, muss ein Fehlercode zurückgegeben werden. Die entsprechenden Felder müssen für das Vorhandensein oder Fehlen von Funktionen festgelegt werden, wenn sie von den folgenden Funktionen zurückgegeben werden:
Dienstanbieter müssen die folgenden Funktionen unterstützen, um mit der Shell kompatibel zu sein:
- Kopieren auf das Gerät (mit Unterstützung für Rückrufe für Abbruch und Status)
- Löschen einer Datei vom Gerät (mit Unterstützung für Rückrufe für Abbruch und Status)
- Umbenennen der Datei auf dem Gerät
- Berichterstellung für Speicherplatz (Gesamtspeicherplatz, freier Speicherplatz, nicht verwendbarer Speicherplatz)
- Plug & Play (siehe Aktivieren von PnP für Geräte)
- Format (vorzugsweise mit Unterstützung für Abbruch- und Statusrückrufe)
Wenn Metadaten unterstützt werden, müssen die folgenden Felder für einzelne Dateien unterstützt werden. Wenn keine Daten verfügbar sind, sollte das Feld als leere Zeichenfolge initialisiert werden:
| Feld | Konstante (definiert in WMDM.idl) | Metadatentag |
|---|---|---|
| Titel des Liedes | g_wszWMDMTitle | WMDM/Titel |
| Tracknummer | g_wszWMDMTrack | WMDM/Track |
| Künstler | g_wszWMDMAuthor | WMDM/Autor |
| Album | g_wszWMDMAlbumTitle | WMDM/AlbumTitle |
| Year | g_wszWMDMYear | WMDM/Jahr |
| Genre | g_wszWMDMGenre | WMDM/Genre |
Parallelität
Kernelmodustreiber für Windows Media-Geräte-Manager müssen bei der Verarbeitung des gleichzeitigen Zugriffs robust sein. Beispielsweise kann ein Benutzer gleichzeitig über die Shell und den Media Player oder einfach über mehrere Fenster in der Shell auf das Gerät zugreifen. Im Rahmen der Parallelitätsbehandlung sollten Treiber nicht davon ausgehen, dass das Gerät verwendet wird, nur weil der Dienstanbieter geladen ist. Stattdessen sollten sie einen Sperrmechanismus implementieren, um den Zugriff auf das Gerät nach Bedarf für einzelne Vorgänge zu serialisieren.
Benutzeroberfläche
Dienstanbieter für Windows Media Geräte-Manager sollte keine Benutzeroberfläche anzeigen. Alle Fehler sollten von Methodenaufrufen als bestimmte Windows Media Geräte-Manager Fehlercodes zurückgegeben werden, wenn möglich.
Aktivieren in der Shell
Wenn Ihr Paket alle Shellanforderungen erfüllt, können Sie die Anzeige Ihres Geräts in der Shell aktivieren, indem Sie unter den Geräteparametern den ShowInShell-Wert auf 1 festlegen. Weitere Informationen finden Sie unter Geräteparameter.
Zugehörige Themen