IMMDeviceEnumerator 인터페이스(mmdeviceapi.h)

IMMDeviceEnumerator 인터페이스는 멀티미디어 디바이스 리소스를 열거하는 메서드를 제공합니다. MMDevice API의 현재 구현에서 이 인터페이스가 열거할 수 있는 유일한 디바이스 리소스는 오디오 엔드포인트 디바이스입니다. 클라이언트는 앞에서 설명한 대로 CoCreateInstance 함수를 호출하여 IMMDeviceEnumerator 인터페이스에 대한 참조를 가져옵니다(MMDevice API 참조).

IMMDeviceEnumerator 인터페이스의 메서드로 열거된 디바이스 리소스는 IMMDevice 인터페이스를 사용하여 개체의 컬렉션으로 표시됩니다. 컬렉션에는 IMMDeviceCollection 인터페이스가 있습니다. IMMDeviceEnumerator::EnumAudioEndpoints 메서드는 디바이스 컬렉션을 만듭니다.

디바이스 컬렉션에 있는 항목의 IMMDevice 인터페이스에 대한 포인터를 가져오기 위해 클라이언트는 IMMDeviceCollection::Item 메서드를 호출합니다.

IMMDeviceEnumerator 인터페이스를 사용하는 코드 예제는 다음 topics 참조하세요.

• 디바이스 속성
• 스트림 렌더링

상속

IMMDeviceEnumerator 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IMMDeviceEnumerator 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IMMDeviceEnumerator 인터페이스에는 이러한 메서드가 있습니다.

IMMDeviceEnumerator::EnumAudioEndpoints EnumAudioEndpoints 메서드는 지정된 조건을 충족하는 오디오 엔드포인트 디바이스 컬렉션을 생성합니다.
IMMDeviceEnumerator::GetDefaultAudioEndpoint GetDefaultAudioEndpoint 메서드는 지정된 데이터 흐름 방향 및 역할에 대한 기본 오디오 엔드포인트를 검색합니다.
IMMDeviceEnumerator::GetDevice GetDevice 메서드는 엔드포인트 ID 문자열로 식별되는 오디오 엔드포인트 디바이스를 검색합니다.
IMMDeviceEnumerator::RegisterEndpointNotificationCallback RegisterEndpointNotificationCallback 메서드는 클라이언트의 알림 콜백 인터페이스를 등록합니다.
IMMDeviceEnumerator::UnregisterEndpointNotificationCallback UnregisterEndpointNotificationCallback 메서드는 IMMDeviceEnumerator::RegisterEndpointNotificationCallback 메서드에 대한 이전 호출에서 클라이언트가 등록한 알림 인터페이스의 등록을 삭제합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mmdeviceapi.h

참고 항목

핵심 오디오 인터페이스

IMMDevice 인터페이스

IMMDeviceCollection 인터페이스

IMMDeviceCollection::Item

IMMDeviceEnumerator::EnumAudioEndpoints

MMDevice API