Media.getItemInfoByType メソッド

[アーティクル]
06/21/2023

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

getItemInfoByType メソッドは、指定した属性名、言語、およびインデックスに対応する属性の値を取得します。

構文

retVal = Media.getItemInfoByType(
  name,
  language,
  index
)

パラメーター

name [in]: 属性の名前を含む文字列。 Windows メディアプレーヤーでサポートされる属性の詳細については、「Windows メディアプレーヤー属性リファレンス」を参照してください。
language [in]: 言語を表す文字列。値が null または "" (空の文字列) に設定されている場合は、現在のロケール文字列が使用されます。それ以外の場合、値は"en-us" などの有効な RFC 1766 言語文字列である必要があります。
index [in]: 属性から取得する値の 0 から始まるインデックスを含む数値 (long)。

戻り値

このメソッドは、次の表に示すように、 Number、 String、 MetadataPicture オブジェクト、または MetadataText オブジェクトを返します。

属性	戻り値
SyncState	Number (unsigned long)
WM/Lyrics_Synchronised	MetadataText オブジェクト
WM/Picture	MetadataPicture オブジェクト
WM/UserWebURL	MetadataText オブジェクト
その他すべての属性	String

基になる値が Boolean の属性の場合、このメソッドは文字列 "true" または "false" を返します。

解説

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

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

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

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

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

このメソッドはエラーを引き起こす可能性があります。このメソッドを呼び出すときは、エラー処理コードを含める必要があります。たとえば、JScript では 、try..を使用してエラー処理を実装できます。キャッチ。。。finally 構造体。

Windows メディアプレーヤー 10 Mobile: この方法はサポートされていません。

要件

要件	値
Version	Windows メディアプレーヤー 9 シリーズ以降。
[DLL]	Wmp.dll

Media.getItemInfoByType メソッド

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース