Método IWMDMNotification::WMDMMessage (mswmdm.h)
O método WMDMMessage é um método de retorno de chamada implementado por um cliente e chamado pelo Windows Media Gerenciador de Dispositivos quando um dispositivo compatível com Plug and Play ou meio de armazenamento é conectado ou removido.
Sintaxe
HRESULT WMDMMessage(
[in] DWORD dwMessageType,
[in] LPCWSTR pwszCanonicalName
);
Parâmetros
[in] dwMessageType
Um DWORD que especifica o tipo de mensagem.
Os valores possíveis para os tipos de evento são os seguintes:
| Tipo de mensagem | Descrição |
|---|---|
| WMDM_MSG_DEVICE_ARRIVAL | Um dispositivo foi conectado. |
| WMDM_MSG_DEVICE_REMOVAL | Um dispositivo foi removido. |
| WMDM_MSG_MEDIA_ARRIVAL | Um meio de armazenamento foi inserido em um dispositivo conectado. |
| WMDM_MSG_MEDIA_REMOVAL | Um meio de armazenamento foi removido de um dispositivo conectado. |
[in] pwszCanonicalName
Ponteiro para uma cadeia de caracteres largo e terminada em nulo especificando o nome canônico do dispositivo para o qual esse evento é gerado. O aplicativo não libera esse valor.
Retornar valor
O valor retornado é um HRESULT no qual o aplicativo pode retornar resultados de seu processamento da mensagem. O valor retornado é ignorado pelo WMDM.
Comentários
Para saber como um aplicativo assina para receber notificações por meio desse método, consulte Habilitando notificações.
Exemplos
O código C++ a seguir implementa o método WMDMMessage e imprime uma mensagem de notificação de chegada ou saída do dispositivo ou armazenamento.
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 | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |