IWMDMNotification::WMDMMessage-Methode (mswmdm.h)

Artikel
03/04/2024

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

Weitere Informationen

Aktivieren von Benachrichtigungen

IWMDMNotification-Schnittstelle

Freigeben über