ユーザー インターフェイスの提供

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 可能な場合は、新しいコードで SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

DSP プラグインは、ユーザー インターフェイスを作成するためのプロパティ ページを提供できます。 これを行うには、 IPropertyPage インターフェイスの実装を提供するプロパティ ページ オブジェクトをプラグインに含める必要があります。 DSP プラグイン オブジェクトは ISpecifyPropertyPages::GetPages を実装する必要があります。これにより、Windows メディア プレーヤーはプラグインの正しいプロパティ ページを見つけて識別できます。

ステータス グラフィックの表示

DSP プラグインは、小さなグラフィックまたは一連のグラフィックスをWindows メディア プレーヤーステータス領域に表示して、プラグインがアクティブであることをユーザーに通知できます。 この機能をサポートするには、プラグインで IPropertyBag インターフェイスを実装する必要があります。 Windows メディア プレーヤーは IPropertyBag::Read を呼び出し、要求されたプロパティ名 "IconStreams" へのポインター (大文字と小文字が区別されます) と、グラフィックのデータを受け取る VARIANT 構造体へのポインターを指定します。 プラグインは IStream オブジェクト (複数のグラフィックスがある場合は IStream オブジェクトの SAFEARRAY) を作成し、ヘッダー情報を含むグラフィック データをストリームに読み込み、VARIANT 構造体の punkVal メンバーを使用して IStream オブジェクトへのポインターを返します。 プラグインがグラフィックを 1 つだけ提供する場合は、VARIANT 構造体の vt メンバーをVT_UNKNOWNとして指定します。 プラグインは、SAFEARRAY を使用して複数のグラフィック IStream オブジェクトを提供する場合、VARIANT 構造体の vt メンバーをVT_ARRAYとして指定します。

グラフィックスは、次のようなさまざまなファイル形式で格納できます。

BMP

Microsoft Windows ビットマップ イメージは圧縮されません。

JPEG

Web ページでよく使用される圧縮イメージ形式。 JPEG フォーマット ファイルには通常、.jpgファイル名拡張子があります。

GIF

Web ページでよく使用される圧縮イメージ形式。

Png

Web ページでよく使用される圧縮イメージ形式。

DSP プラグイン グラフィックスの最大寸法は、幅 38 ピクセル、高さ 14 ピクセルです。

ステータス グラフィックを含む IStream バイト ストリームには、ヘッダー情報を含める必要があります。 ヘッダー情報がないと、Windows メディア プレーヤーはグラフィックの種類を正しく識別できないため、イメージは読み込まれません。

DSP プラグイン開発者の概要