IWMDMNotification ::WMDMMessage, méthode (mswmdm.h)

Article
03/04/2024

La méthode WMDMMessage est une méthode de rappel implémentée par un client et appelée par Windows Media Gestionnaire de périphériques lorsqu’un appareil ou support de stockage conforme Plug-and-Play est connecté ou supprimé.

Syntaxe

HRESULT WMDMMessage(
  [in] DWORD   dwMessageType,
  [in] LPCWSTR pwszCanonicalName
);

Paramètres

[in] dwMessageType

DWORD spécifiant le type de message.

Les valeurs possibles pour les types d’événements sont les suivantes :

type de message	Description
WMDM_MSG_DEVICE_ARRIVAL	Un appareil a été connecté.
WMDM_MSG_DEVICE_REMOVAL	Un appareil a été supprimé.
WMDM_MSG_MEDIA_ARRIVAL	Un support de stockage a été inséré dans un appareil connecté.
WMDM_MSG_MEDIA_REMOVAL	Un support de stockage a été supprimé d’un appareil connecté.

[in] pwszCanonicalName

Pointeur vers une chaîne à caractères larges et terminée par null spécifiant le nom canonique de l’appareil pour lequel cet événement est généré. L’application ne libère pas cette valeur.

Valeur retournée

La valeur de retour est un HRESULT dans lequel l’application peut retourner les résultats de son traitement du message. La valeur de retour est ignorée par WMDM.

Remarques

Pour savoir comment une application s’abonne pour recevoir des notifications via cette méthode, consultez Activation des notifications.

Exemples

Le code C++ suivant implémente la méthode WMDMMessage et imprime un message de notification d’arrivée ou de départ d’un appareil ou d’un stockage.


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.
}

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

Activation des notifications

IWMDMNotification, interface

Partager via