IWMDMNotification::WMDMMessage-Methode (mswmdm.h)
Die WMDMMessage-Methode ist eine Rückrufmethode, die von einem Client implementiert und von Windows Media Geräte-Manager aufgerufen wird, wenn ein Plug & Play kompatibles Gerät oder Speichermedium verbunden oder entfernt wird.
Syntax
HRESULT WMDMMessage(
[in] DWORD dwMessageType,
[in] LPCWSTR pwszCanonicalName
);
Parameter
[in] dwMessageType
Ein DWORD , das den Nachrichtentyp angibt.
Die möglichen Werte für die Ereignistypen sind die folgenden:
| Nachrichtentyp | BESCHREIBUNG |
|---|---|
| WMDM_MSG_DEVICE_ARRIVAL | Ein Gerät wurde verbunden. |
| WMDM_MSG_DEVICE_REMOVAL | Ein Gerät wurde entfernt. |
| WMDM_MSG_MEDIA_ARRIVAL | Ein Speichermedium wurde in ein verbundenes Gerät eingefügt. |
| WMDM_MSG_MEDIA_REMOVAL | Ein Speichermedium wurde von einem verbundenen Gerät entfernt. |
[in] pwszCanonicalName
Zeiger auf eine Breitzeichenzeichenfolge mit NULL-Beendigung, die den kanonischen Namen des Geräts angibt, für das dieses Ereignis generiert wird. Die Anwendung gibt diesen Wert nicht frei.
Rückgabewert
Der Rückgabewert ist ein HRESULT, in dem die Anwendung Ergebnisse der Verarbeitung der Nachricht zurückgeben kann. Der Rückgabewert wird von WMDM ignoriert.
Hinweise
Informationen dazu, wie eine Anwendung Benachrichtigungen über diese Methode abonniert, finden Sie unter Aktivieren von Benachrichtigungen.
Beispiele
Der folgende C++-Code implementiert die WMDMMessage-Methode und druckt eine Geräte- oder Speicherbenachrichtigung aus.
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.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |