MediaCollection.getMediaAtom 메서드

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

getMediaAtom 메서드는 지정된 특성이 사용 가능한 특성 집합 내에 있는 인덱스를 검색합니다.

구문

retVal = MediaCollection.getMediaAtom(
  attribute
)

매개 변수

특성 [in]

특성 이름을 포함하는 문자열입니다. Windows 미디어 플레이어 지원하는 특성에 대한 자세한 내용은 Windows 미디어 플레이어 특성 참조를 참조하세요.

반환 값

이 메서드는 Number (long)를 반환합니다.

설명

이 메서드를 사용하여 검색된 인덱스 번호를 Media에 전달할 수 있습니다. 특성 값에 액세스하는 getItemInfoByAtom 메서드입니다. 이 기술은 일반적으로 Media를 통해 이름으로 특성 값에 액세스하는 것보다 큰 재생 목록으로 작업할 때 더 효율적입니다. getItemInfo 또는 Media. getItemInfoByType.

이 메서드를 사용하려면 라이브러리에 대한 읽기 권한이 필요합니다. 자세한 내용은 라이브러리 액세스를 참조하세요.

요구 사항

요구 사항	값
버전	Windows 미디어 플레이어 버전 7.0 이상.
DLL	Wmp.dll

추가 정보

Media.getItemInfo

Media.getItemInfoByAtom

Media.getItemInfoByType

MediaCollection 개체

Settings.mediaAccessRights

Settings.requestMediaAccessRights