Bereitstellen eines Benutzeroberfläche
DSP-Plug-Ins können eine Eigenschaftenseite zum Erstellen einer Benutzeroberfläche bereitstellen. Hierzu muss das Plug-In ein Eigenschaftenseitenobjekt enthalten, das eine Implementierung einer IPropertyPage-Schnittstelle bereitstellt. Das DSP-Plug-In-Objekt muss ISpecifyPropertyPages::GetPages implementieren, wodurch Windows Media Player die richtige Eigenschaftenseite für das Plug-In suchen und identifizieren kann.
Anzeigen einer Statusgrafik
DSP-Plug-Ins können eine kleine Grafik oder eine Reihe von Grafiken im Statusbereich Windows Media Player anzeigen, um den Benutzer zu benachrichtigen, dass ein Plug-In aktiv ist. Um dieses Feature zu unterstützen, muss das Plug-In die IPropertyBag-Schnittstelle implementieren. Windows Media Player ruft IPropertyBag::Read auf und stellt einen Zeiger auf den angeforderten Eigenschaftennamen "IconStreams" bereit, bei dem die Groß-/Kleinschreibung beachtet wird, und einen Zeiger auf eine VARIANT-Struktur, die die Daten für die Grafik empfängt. Das Plug-In erstellt ein IStream-Objekt (oder ein SAFEARRAY von IStream-Objekten, wenn mehrere Grafiken vorhanden sind), lädt dann die Grafikdaten einschließlich Headerinformationen in den Stream und gibt dann einen Zeiger auf das IStream-Objekt zurück, indem der elementval-Member der VARIANT-Struktur verwendet wird. Wenn das Plug-In nur eine Grafik enthält, gibt es den vt-Member der VARIANT-Struktur als VT _ UNKNOWN an. Wenn das Plug-In mehrere grafische IStream-Objekte mit einem SAFEARRAY-Objekt angibt, gibt es den vt-Member der VARIANT-Struktur als VT _ ARRAY an.
Grafiken können in einer Vielzahl von Dateiformaten gespeichert werden, einschließlich:
BMP
Microsoft Windows Bitmapbilder sind nicht komprimiert.
JPEG
Komprimiertes Bildformat, das häufig für Webseiten verwendet wird. JPEG-Formatdateien weisen in der Regel .jpg Dateinamenerweiterungen auf.
GIF
Komprimiertes Bildformat, das häufig für Webseiten verwendet wird.
PNG
Komprimiertes Bildformat, das häufig für Webseiten verwendet wird.
Die maximalen Abmessungen für DSP-Plug-In-Grafiken sind 38 Pixel breit und 14 Pixel hoch.
Der IStream-Bytestream, der die Statusgrafik enthält, muss Headerinformationen enthalten. Ohne Headerinformationen kann Windows Media Player den Grafiktyp nicht ordnungsgemäß identifizieren und lädt daher das Bild nicht.