[Topic 6] IMMDeviceEnumerator Interface

[Topic 6] IMMDeviceEnumerator Interface
The IMMDeviceEnumerator interface provides methods for enumerating multimedia device resources.
IMMDeviceEnumerator interface는 멀티미디어 장치 리소스 열거를 위한 방법을 제공한다.

In the current implementation of the MMDevice API, the only device resources that this interface can enumerate are audio endpoint devices.
이 인터페이스는 현재 MMDevice API에서 유일하게 장치 리소스 오디오 엔드포인트 장치를 열거할 수 있는 인터페이스이다.
A client obtains a reference to an IMMDeviceEnumerator interface by calling the CoCreateInstance function, as described previously (see MMDevice API).
CoCreateInstance 함수를 호출하여 IMMDeviceEnumerator interface의 레퍼런스를얻을 수 있다. 이전에 설명했다 (MMDevice API 참조)

The device resources enumerated by the methods in the IMMDeviceEnumerator interface are represented as collections of objects with IMMDevice interfaces.
IMMDeviceEnumerator interface은 IMMDevice interfaces와 함께 수집된 객체를 수집하고 표시하는 함수들에 의해 장치 리소스를 열거한다.
A collection has an IMMDeviceCollection interface.
IMMDeviceCollection interface은 수집한다.
The IMMDeviceEnumerator::EnumAudioEndpoints method creates a device collection.
IMMDeviceEnumerator::EnumAudioEndpoints 함수는 장치 컬렉션을 생성한다.
To obtain a pointer to the IMMDevice interface of an item in a device collection, the client calls the IMMDeviceCollection::Item method.
수집된 장치 안에서  IMMDevice interface의 item의 포인터를 얻기 위해, 클라이언트는 IMMDeviceCollection::Item 함수를 호출한다.
For code examples that use the IMMDeviceEnumerator interface, see the following topics:
IMMDeviceEnumerator interface를 사용하는 예제 코드는, 다음 주제을 보면 된다.

- Device Properties
- Rendering a Stream

Methods
The IMMDeviceEnumerator interface inherits the methods of the IUnknown interface.
IMMDeviceEnumerator interface는 IUnknown interface의 함수를 상속받는다.
In addition, IMMDeviceEnumerator defines the following methods.
추가로, IMMDeviceEnumerator 은 다음과 같은 함수를 포함한다.

--------------------------------------------------------------------------------------------------------------------------------------------
Method      | Description
--------------------------------------------------------------------------------------------------------------------------------------------
EnumAudioEndpoints   | Generates a collection of audio endpoint devices that meet the specified criteria.
     | 지정한 기준을 만족하는 오디오 종점 장치의 컬렉션을 생성.
--------------------------------------------------------------------------------------------------------------------------------------------
GetDefaultAudioEndpoint   | Retrieves the default audio endpoint for the specified data-flow direction and role.
     | 지정된 데이터 흐름의 방향과 룰을 가져오기 위한 디폴트 오디오 엔드포인트를 반환한다.
--------------------------------------------------------------------------------------------------------------------------------------------
GetDevice    | Retrieves an endpoint device that is specified by an endpoint device-identification string.
     | 지정된 엔드포인트 장치 식별 문자열에 의해 에드포인트 장치를 반환한다.
--------------------------------------------------------------------------------------------------------------------------------------------
RegisterEndpointNotificationCallback | Registers a client's notification callback interface.
     | 클라이언트들 통지할 콜백 인터페이스를 등록한다.
--------------------------------------------------------------------------------------------------------------------------------------------
UnregisterEndpointNotificationCallback | Deletes the registration of a notification interface that the client registered in
     | a previous call to the IMMDeviceEnumerator::RegisterEndpointNotificationCallback method.
     | IMMDeviceEnumerator::RegisterEndpointNotificationCallback 함수 호출에 의해 등록된 클라이언트를 삭제한다.
--------------------------------------------------------------------------------------------------------------------------------------------