Método IWMDMNotification::WMDMMessage (mswmdm.h)
El método WMDMMessage es un método de devolución de llamada implementado por un cliente y lo llama Windows Media Administrador de dispositivos cuando se conecta o quita un dispositivo compatible Plug and Play o medio de almacenamiento.
Sintaxis
HRESULT WMDMMessage(
[in] DWORD dwMessageType,
[in] LPCWSTR pwszCanonicalName
);
Parámetros
[in] dwMessageType
DWORD que especifica el tipo de mensaje.
Los valores posibles para los tipos de eventos son los siguientes:
| Tipo de mensaje | Descripción |
|---|---|
| WMDM_MSG_DEVICE_ARRIVAL | Se ha conectado un dispositivo. |
| WMDM_MSG_DEVICE_REMOVAL | Se ha quitado un dispositivo. |
| WMDM_MSG_MEDIA_ARRIVAL | Se ha insertado un medio de almacenamiento en un dispositivo conectado. |
| WMDM_MSG_MEDIA_REMOVAL | Se ha quitado un medio de almacenamiento de un dispositivo conectado. |
[in] pwszCanonicalName
Puntero a una cadena terminada en null de caracteres anchos que especifica el nombre canónico del dispositivo para el que se genera este evento. La aplicación no libera este valor.
Valor devuelto
El valor devuelto es un HRESULT en el que la aplicación puede devolver los resultados de su procesamiento del mensaje. WMDM omite el valor devuelto.
Comentarios
Para obtener información sobre cómo una aplicación se suscribe para recibir notificaciones a través de este método, consulte Habilitación de notificaciones.
Ejemplos
El siguiente código de C++ implementa el método WMDMMessage e imprime un mensaje de notificación de llegada o salida de un dispositivo o almacenamiento.
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.
}
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | mswmdm.h |
| Library | Mssachlp.lib |