MediaCollection.getMediaAtom メソッド

  • [アーティクル]

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

getMediaAtom メソッドは、指定した属性が使用可能な属性のセット内に存在するインデックスを取得します。

構文

retVal = MediaCollection.getMediaAtom(
  attribute
)

パラメーター

属性 [in]

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

戻り値

このメソッドは Number (long) を返します。

解説

このメソッドで取得したインデックス番号は Media に渡 すことができます。属性値にアクセスするための getItemInfoByAtom メソッド。 一般に、この手法は、大きなプレイリストを操作する場合、 Media を介して名前で属性値にアクセスするよりも効率的です。getItemInfo または Media。getItemInfoByType。

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

必要条件

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

関連項目

Media.getItemInfo

Media.getItemInfoByAtom

Media.getItemInfoByType

MediaCollection オブジェクト

Settings.mediaAccessRights

Settings.requestMediaAccessRights