Media.getItemInfoByAtom メソッド

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

getItemInfoByAtom メソッドは、指定したインデックス番号を持つ属性の値を取得します。

構文

strRetVal = Media.getItemInfoByAtom(
  index
)

パラメーター

index [in]

特定の属性が使用可能な属性のセット内に存在するインデックスを指定する数値 (long)。

戻り値

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

解説

このメソッドは、属性インデックス番号を使用して、特定のデジタル メディア項目のメタデータを取得するために使用できます。 attributeCount プロパティを使用して、メディアアイテムで使用できる属性の数を決定できます。

MediaCollection オブジェクトの getMediaAtom メソッドを使用して、特定の属性のインデックスを取得することもできます。 この手法は、通常、大規模なプレイリストを操作する場合、 getItemInfo メソッドまたは getItemInfoByType メソッドよりも効率的です。

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

Windows メディア プレーヤーでサポートされる属性の詳細については、「Windows メディア プレーヤー属性リファレンス」を参照してください

Windows メディア プレーヤー 10 Mobile: メディア アイテムの属性は、メディア コレクションを介してアイテムから取得されない限り、再生中にのみ使用できます。

必要条件

要件
Version
バージョン 7.0 以降Windows メディア プレーヤー。
[DLL]
Wmp.dll

関連項目

Media オブジェクト

Media.attributeCount

Media.getItemInfo

Media.getItemInfoByType

Media.setItemInfo

MediaCollection.getMediaAtom

属性値の読み取り

Settings.mediaAccessRights

Settings.requestMediaAccessRights