IWMDMNotification::WMDMMessage 메서드(mswmdm.h)
WMDMMessage 메서드는 클라이언트에서 구현한 콜백 메서드이며, 플러그 앤 플레이 규격 디바이스 또는 스토리지 매체가 연결되거나 제거될 때 Windows Media 장치 관리자 호출됩니다.
구문
HRESULT WMDMMessage(
[in] DWORD dwMessageType,
[in] LPCWSTR pwszCanonicalName
);
매개 변수
[in] dwMessageType
메시지 유형을 지정하는 DWORD 입니다.
이벤트 유형에 사용할 수 있는 값은 다음과 같습니다.
| 메시지 유형 | Description |
|---|---|
| WMDM_MSG_DEVICE_ARRIVAL | 디바이스가 연결되었습니다. |
| WMDM_MSG_DEVICE_REMOVAL | 디바이스가 제거되었습니다. |
| WMDM_MSG_MEDIA_ARRIVAL | 연결된 디바이스에 스토리지 미디어가 삽입되었습니다. |
| WMDM_MSG_MEDIA_REMOVAL | 연결된 디바이스에서 스토리지 미디어가 제거되었습니다. |
[in] pwszCanonicalName
이 이벤트가 생성되는 디바이스의 정식 이름을 지정하는 와이드 문자 null로 끝나는 문자열에 대한 포인터입니다. 애플리케이션이 이 값을 해제하지 않습니다.
반환 값
반환 값은 애플리케이션이 메시지 처리 결과를 반환할 수 있는 HRESULT 입니다. 반환 값은 WMDM에서 무시됩니다.
설명
애플리케이션이 이 방법을 통해 알림을 수신하도록 구독하는 방법을 알아보려면 알림 사용을 참조하세요.
예제
다음 C++ 코드는 WMDMMessage 메서드를 구현하고 디바이스 또는 스토리지 도착 또는 출발 알림 메시지를 출력합니다.
HRESULT WMDMMessage(DWORD dwMessageType, LPCWSTR pwszCanonicalName)
{
switch(dwMessageType)
{
case WMDM_MSG_DEVICE_ARRIVAL:
// TODO: Display a message indicating that a new device has been detected and display the device name.
break;
case WMDM_MSG_DEVICE_REMOVAL:
// TODO: Display a message that the device has been removed and display the device name.
break;
case WMDM_MSG_MEDIA_ARRIVAL:
// TODO: Display a message indicating that storage media has been added to the device and display the device name.
break;
case WMDM_MSG_MEDIA_REMOVAL:
// TODO: Display a message that storage media has been removed from the device and display the device name.
break;
default:
// TODO: Display a message indicating that an unidentified message has been received.
break;
}
return S_OK; // Return value is ignored, and not returned to the application.
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | mswmdm.h |
| 라이브러리 | Mssachlp.lib |