IWMPMediaCollection::getByGenre 메서드

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

메서드는 getByGenre 지정된 장르의 미디어 항목에 대한 액세스를 제공하는 IWMPPlaylist 인터페이스를 반환합니다.

구문

public IWMPPlaylist getByGenre(
  System.String bstrGenre
);

Public Function getByGenre( _
  ByVal bstrGenre As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByGenre

매개 변수

bstrGenre [in]

장르의 이름인 System.String 입니다.

반환 값

검색된 미디어 항목에 대한 WMPLib.IWMPPlaylist 인터페이스입니다.

설명

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

IWMPMediaCollection 인터페이스를 검색하는 방법에는 두 가지가 있으며 메서드의 getByGenre 동작은 사용하는 두 가지 방법에 따라 달라집니다. AxWindowsMediaPlayer.mediaCollection을 호출하여 인터페이스를 검색하는 경우 메서드는 getByGenre 라이브러리의 모든 미디어 항목을 반환합니다. 그러나 IWMPLibrary.mediaCollection을 호출하여 인터페이스를 검색하는 경우 메서드는 getByGenre 지정된 특성과 값이 있는 라이브러리의 오디오 항목만 반환합니다.

예제

다음 예제에서는 를 사용하여 getByGenre 사용자가 단추를 클릭할 때 미디어 항목의 재생 목록을 검색합니다. 재생 목록에는 텍스트 상자에서 사용자가 지정한 장르의 항목이 포함됩니다. AxWMPLib.AxWindowsMediaPlayer 개체는 player라는 변수로 표시됩니다.

private void playGenre_Click(object sender, System.EventArgs e)
{ 
    // ...Add code to ensure that the text box contains a valid value.
 
    // Retrieve the genre that the user entered in the text box. 
    string genre = getGenre.Text;

    // Create the playlist using getByGenre. 
    WMPLib.IWMPPlaylist pl = player.mediaCollection.getByGenre(genre);

    // Make the new playlist the current playlist. 
    player.currentPlaylist = pl;

    // Play the media in the current playlist. 
    player.Ctlcontrols.play();
}

Public Sub playGenre_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles playGenre.Click

    ' ...Add code to ensure that the text box contains a valid value.

    ' Retrieve the genre that the user entered in the text box. 
    Dim genre As String = getGenre.Text

    ' Create the playlist using getByGenre. 
    Dim pl As WMPLib.IWMPPlaylist = player.mediaCollection.getByGenre(genre)

    ' Make the new playlist the current playlist. 
    player.currentPlaylist = pl

    ' Play the media in the current playlist. 
    player.Ctlcontrols.play()

End Sub

요구 사항

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

추가 정보

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

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