IWMPMedia3::getItemInfoByType メソッド

  • [アーティクル]

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

getItemInfoByType メソッドは、指定した属性の種類とインデックスに対応する属性の値を返します。

構文

public System.Object getItemInfoByType(
  System.String bstrType,
  System.String bstrLanguage,
  System.Int32 lIndex
);


Public Function getItemInfoByType( _
  ByVal bstrType As System.String, _
  ByVal bstrLanguage As System.String, _
  ByVal lIndex As System.Int32 _
) As System.Object
Implements IWMPMedia3.getItemInfoByType

パラメーター

bstrType [in]

属性型である System.String 。

bstrLanguage [in]

言語である System.String 。 値が null または長さ 0 の文字列 ("") に設定されている場合は、現在のロケール文字列が使用されます。 それ以外の場合、値は"en-us" などの有効な RFC 1766 言語文字列である必要があります。

lIndex [in]

属性インデックスである System.Int32 。

戻り値

属性の値である System.Object 。 このオブジェクトをキャストする型は、 属性の型によって異なります。

解説

このメソッドは、個々のデジタル メディアアイテムまたはプレイリストの一部であるメディアアイテムのメタデータを返します。

このメソッドは、複数の値を持つ属性と複雑な値を持つ属性をサポートします。 getItemInfo メソッドでは、複数の値を持つ属性と複雑な値を持つ属性はサポートされていません。

attributeCount プロパティは、特定のメディア アイテムで使用できる属性名の数を取得します。 その後、 getAttributeName メソッドと共にインデックス番号を使用して、使用可能な各属性の名前を決定できます。 個々の属性名は、getItemInfoByType の name パラメーターに渡すことができます。

getAttributeCountByType メソッドは、特定のメディア アイテムの特定の属性名に対応する属性の数を返します。 その後、インデックス番号を getItemInfoByType のインデックス パラメーターに渡すことができます。 これは、たとえば、メディア アイテムが複数のジャンルに分類されている場合に便利です。

IWMPLibrary.mediaCollection を呼び出して取得されたライブラリからメディア アイテムが取得された場合、使用可能な属性のセットは、AxWindowsMediaPlayer.mediaCollection を呼び出して取得したローカル ライブラリから照会できる属性とは異なります。 たとえば、 IWMPLibrary を使用して取得したローカル ライブラリから使用できる属性は、 AxWindowsMediaPlayer を使用して取得したローカル ライブラリから使用できる属性のサブセットになります。 他のソース (リモート ライブラリ、ポータブル デバイス、または ID) から使用できる属性のセットは、他のソースによって定義されます。

このメソッドを呼び出す前に、ライブラリへの読み取りアクセス権が必要です。 詳細については、「 ライブラリ アクセス」を参照してください。

必要条件

要件 値
Version
 Windows メディア プレーヤー 9 シリーズ以降
名前空間
 WMPLib
アセンブリ
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

関連項目

IWMPMedia3 インターフェイス (VB および C#)

IWMPMedia.attributeCount (VB および C#)

IWMPMedia.getAttributeName (VB および C#)

IWMPMedia.getItemInfo (VB および C#)

IWMPMedia3.getAttributeCountByType (VB および C#)