다음을 통해 공유

IWMPMediaCollection::add 메서드

  • 아티클

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

add 메서드는 라이브러리에 새 미디어 항목 또는 재생 목록을 추가합니다.

구문

public IWMPMedia add(
  System.String bstrURL
);


Public Function add( _
  ByVal bstrURL As System.String _
) As IWMPMedia
Implements IWMPMediaCollection.add

매개 변수

bstrURL [in]

미디어 항목 또는 재생 목록의 위치를 지정하는 URL인 System.String 입니다.

반환 값

추가된 항목 또는 재생 목록에 대한 WMPLib.IWMPMedia 인터페이스입니다.

설명

이 메서드는 경로가 지정된 기존 미디어 항목 또는 재생 목록을 라이브러리에 로드합니다. 이 메서드는 파일을 이동하거나 변경하지 않습니다. 잘못된 로컬 경로가 지정된 경우 이 메서드가 실패하지만 미디어 항목 자체는 라이브러리에 추가되기 전에 유효성을 검사하지 않습니다.

이 메서드는 정적 및 자동 재생 목록 파일을 모두 허용합니다. IWMPPlaylistCollection.importPlaylist 메서드를 사용하여 라이브러리에 정적 재생 목록을 추가할 수도 있습니다.

이 메서드를 호출하기 전에 라이브러리에 대한 모든 권한이 있어야 합니다. 자세한 내용은 라이브러리 액세스를 참조하세요.

예제

다음 예제에서는 Windows 미디어 플레이어 미디어 컬렉션에 세 개의 미디어 개체를 추가합니다. AxWMPLib.AxWindowsMediaPlayer 개체는 player라는 변수로 표시됩니다.

// Adding a media object using a website.
player.mediaCollection.add("https://www.proseware.com/Media/Laure.wma");

// Adding a media object from a local network.
// Either use the @ symbol to denote a quoted string literal or add additional
// backlashes as an escape for every original backslash.
player.mediaCollection.add(@"\\yourservername\Public\Jeanne.wma");

// Adding a media object from a file on a local drive.
// Either use the @ symbol to denote a quoted string literal or add additional
// backlashes as an escape for every original backslash.
player.mediaCollection.add(@"C:\WMSDK\WMPSDK\samples\media\house.wma");


' Adding a media object using a website.
player.mediaCollection.add("http:'www.proseware.com/Media/Laure.wma")

' Adding a media object from a local network.
player.mediaCollection.add("\\yourservername\Public\Jeanne.wma")

' Adding a media object from a file on a local drive.
player.mediaCollection.add("C:\WMSDK\WMPSDK\samples\media\house.wma")

요구 사항

요구 사항 값
버전
 Windows 미디어 플레이어 9 시리즈 이상
네임스페이스
 WMPLib
어셈블리
Interop.WMPLib.dll(Interop.WMPLib.dll.dll)

추가 정보

IWMPMediaCollection 인터페이스(VB 및 C#)

IWMPMediaCollection.remove(VB 및 C#)

IWMPPlaylistCollection.importPlaylist(VB 및 C#)