[Topic 8] IMMNotificationClient Interface
The IMMNotificationClient interface provides notifications when an audio endpoint device is added or removed, when the state or properties of an endpoint device change, or when there is a change in the default role assigned to an endpoint device.
IMMNotificationClient interface는 오디오 엔드포인트 장치가 추가되거나 삭제될때, 엔드포인트 장치의 속성에 변화가 생겼을때, 또는 엔드포인트 장치에서 디폴트 룰 할당이 변경되었을때 통지를 보내는 것을 제공한다.
Unlike the other interfaces in this section, which are implemented by the MMDevice API system component, an MMDevice API client implements the IMMNotificationClient interface.
이 섹션은 다른 인터페이스와는 달리, MMDevice API 시스템 컴포넌트에 의해 구현된다, MMDevice API는 클라이언트 IMMNotificationClient interface를 구현한다.
To receive notifications, the client passes a pointer to its IMMNotificationClient interface instance as a parameter to the IMMDeviceEnumerator::RegisterEndpointNotificationCallback method.
알림를 수신하려면 , IMMNotificationClient interface 인스턴스의 포인터를 IMMDeviceEnumerator::RegisterEndpointNotificationCallback 함수의 파라미터로 전달한다.
After registering its IMMNotificationClient interface, the client receives event notifications in the form of callbacks through the methods of the interface.
IMMNotificationClient interface 등록한 후에, 클라이언트 콜백의 형태로 인터페이스의 메서드를 통해 이벤트 알림을 받는다.
Each method in the IMMNotificationClient interface receives, as one of its input parameters, an endpoint ID string that identifies the audio endpoint device that is the subject of the notification.
IMMNotificationClient interface의 각 함수는, 하나의 입력 파라미터와 오디오 엔드포인트 장치의 식별을 위한 엔드포인트 ID 문자열을 리턴으로 통지를 받습니다.
The string uniquely identifies the device with respect to all of the other audio endpoint devices in the system.
모든 시스템내에 오디오 엔드포인트 장치들 중 하나의 오디오 엔드포인트 장치를 유일하게 식별할 수 있는 문자열이다.
The methods in the IMMNotificationClient interface implementation should treat this string as opaque.
IMMNotificationClient interface를 구현하는 방법으로 이 문자열을 불투명하게 구현해야 한다.
That is, none of the methods should attempt to parse the contents of the string to obtain information about the device.
즉, 누구든 장치에 대해 정보를 얻기 위해 문자열의 내용을 분석하기위한 시도를 해야 한다.
The reason is that the string format is undefined and might change from one implementation of the MMDevice API system module to the next.
이유는 문자열 형식 정의되지 않았고 MMDevice API는 시스템이 모듈을 하나의 구현에서 다음을 변경할 수도있습니다.
A client can use the endpoint ID string that it receives as an input parameter in a call to an IMMNotificationClient method in two ways:
클라이언트는 두가지 방법으로 MMNotificationClient 함수를 호출하여 입력 파라미터를 수신하기 위해 엔드포인트 ID 문자열을 사용할 수 있다.
- The client can create an instance of the device that the endpoint ID string identifies.
클라이언트는 장치를 식별하기 위한 에드포인트 ID 문자열을 생성할 수 있다.
The client does this by calling the IMMDeviceEnumerator::GetDevice method and supplying the endpoint ID string as an input parameter.
클라이언트는IMMDeviceEnumerator::GetDevice 함수를 호출하고 입력 파라미터로 엔드포인트 ID문자열을 제공할 수 있다.
-The client can compare the endpoint ID string with the endpoint ID string of an existing device instance. To obtain the second endpoint ID string, the client calls the IMMDevice::GetId method of the device instance.
클라이언트는 존재하는 장치 인스턴스의 엔드포인트 ID 문자열과 함께 엔드포인트 ID 문자열을 비교할 수 있다. 두번째 엔드포인트 ID 문자열을 얻기 위해서는 장치 인스턴스의 IMMDevice::GetId 함수 호출한다.
If the two strings match, they identify the same device.
만약 두 문자열이 같다면 그들은 같은 장치를 식별한다.
In implementing the IMMNotificationClient interface, the client should observe these rules to avoid deadlocks and undefined behavior:
IMMNotificationClient interface 구현에서, 데드락과 정의되지 않은 문제를 방지하려면 다음 규칙을 준수해야 한다.
- The methods of the interface must be nonblocking. The client should never wait on a synchronization object during an event callback.
이 인터페이스 함수는 넌블럭킹이어야 한다. 클라이언트는 이벤트 콜백동안 동기화 개체는 결코 기다려서는 안된다.
- The client should never call the IMMDeviceEnumerator::UnregisterEndpointNotificationCallback method during an event callback.
이벤트 콜백 동안 IMMDeviceEnumerator::UnregisterEndpointNotificationCallback 함수는 결코 호출되면 안된다.
- The client should never release the final reference on an MMDevice API object during an event callback.
이벤트 콜백 동안 MMDevice API 객체의 마지막 레퍼런스는 결코 릴리즈 되면 안된다.
For a code example that implements the IMMNotificationClient interface, see Device Events.
Methods
The IMMNotificationClient interface inherits the methods of the IUnknown interface.
In addition, IMMNotificationClient defines the following methods.
--------------------------------------------------------------------------------------------------------------------------------------------
Method | Description
--------------------------------------------------------------------------------------------------------------------------------------------
OnDefaultDeviceChanged | Notifies the client that the default audio endpoint device for a particular role has changed.
| 특정 역활에 대한 기본 오디오 엔드포인트 장치가 변경되었음을 클라이언트에게 알림
--------------------------------------------------------------------------------------------------------------------------------------------
OnDeviceAdded | Indicates that a new audio endpoint device has been added.
| 새로운 오디오 엔드포인트 장치가 추가되었음을 나타낸다
--------------------------------------------------------------------------------------------------------------------------------------------
OnDeviceRemoved | Indicates that an audio endpoint device has been removed.
| 오디오 엔드포인트 장치가 삭제되었음을 나타낸다.
--------------------------------------------------------------------------------------------------------------------------------------------
OnDeviceStateChanged | Indicates that the state of an audio endpoint device has changed.
| 오디오 엔드포인트 장치의 상태가 변경되었음을 나타낸다.
--------------------------------------------------------------------------------------------------------------------------------------------
OnPropertyValueChanged | Indicates that the value of a property belonging to an audio endpoint device has changed.
| 오디오 엔드포인트 장치에 속성 성절 값이 변경됨을 나타낸다.
--------------------------------------------------------------------------------------------------------------------------------------------
최근 덧글