Metodo IWMDMNotification::WMDMMessage (mswmdm.h)
Il metodo WMDMMessage è un metodo di callback implementato da un client e chiamato da Windows Media Gestione dispositivi quando un dispositivo o un supporto di archiviazione conforme Plug and Play è connesso o rimosso.
Sintassi
HRESULT WMDMMessage(
[in] DWORD dwMessageType,
[in] LPCWSTR pwszCanonicalName
);
Parametri
[in] dwMessageType
DWORD che specifica il tipo di messaggio.
I valori possibili per i tipi di evento sono i seguenti:
| Tipo di messaggio | Descrizione |
|---|---|
| WMDM_MSG_DEVICE_ARRIVAL | Un dispositivo è stato connesso. |
| WMDM_MSG_DEVICE_REMOVAL | Un dispositivo è stato rimosso. |
| WMDM_MSG_MEDIA_ARRIVAL | Un supporto di archiviazione è stato inserito in un dispositivo connesso. |
| WMDM_MSG_MEDIA_REMOVAL | Un supporto di archiviazione è stato rimosso da un dispositivo connesso. |
[in] pwszCanonicalName
Puntatore a una stringa con terminazione Null a caratteri wide che specifica il nome canonico del dispositivo per il quale viene generato questo evento. L'applicazione non rilascia questo valore.
Valore restituito
Il valore restituito è un valore HRESULT in cui l'applicazione può restituire i risultati dell'elaborazione del messaggio. Il valore restituito viene ignorato da WMDM.
Commenti
Per informazioni su come un'applicazione sottoscrive la ricezione di notifiche tramite questo metodo, vedere Abilitazione delle notifiche.
Esempio
Il codice C++ seguente implementa il metodo WMDMMessage e stampa un messaggio di notifica di arrivo o partenza del dispositivo o dell'archiviazione.
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.
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |