CM_NOTIFY_EVENT_DATA structure (cfgmgr32.h)

Il s’agit d’une structure de données d’événement de notification d’appareil.

Syntaxe

typedef struct _CM_NOTIFY_EVENT_DATA {
  CM_NOTIFY_FILTER_TYPE FilterType;
  DWORD                 Reserved;
  union {
    struct {
      GUID  ClassGuid;
      WCHAR SymbolicLink[ANYSIZE_ARRAY];
    } DeviceInterface;
    struct {
      GUID  EventGuid;
      LONG  NameOffset;
      DWORD DataSize;
      BYTE  Data[ANYSIZE_ARRAY];
    } DeviceHandle;
    struct {
      WCHAR InstanceId[ANYSIZE_ARRAY];
    } DeviceInstance;
  } u;
} CM_NOTIFY_EVENT_DATA, *PCM_NOTIFY_EVENT_DATA;

Membres

FilterType

Le CM_NOTIFY_FILTER_TYPE de la structure CM_NOTIFY_FILTER utilisée dans l’inscription qui a généré ces données d’événement de notification.

Reserved

Réservé. Doit être égal à 0.

u

Union qui contient des informations sur les données d’événement de notification. Pour déterminer le membre de l’union à examiner, case activée le FilterType des données d’événement.

u.DeviceInterface

Examinez cette partie de l’union lorsque le FilterType est CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE.

u.DeviceInterface.ClassGuid

GUID de la classe d’interface d’appareil pour l’interface d’appareil à laquelle se rapportent les données d’événement de notification.

u.DeviceInterface.SymbolicLink[ANYSIZE_ARRAY]

Chemin de liaison symbolique de l’interface d’appareil à laquelle se rapportent les données d’événement de notification.

u.DeviceHandle

Examinez cette partie de l’union lorsque le FilterType est CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE et que l’action de notification est CM_NOTIFY_ACTION_DEVICECUSTOMEVENT.

u.DeviceHandle.EventGuid

GUID de l’événement personnalisé.

u.DeviceHandle.NameOffset

Décalage d’une mémoire tampon de chaîne facultative. L’utilisation dépend du contrat de l’EventGuid.

u.DeviceHandle.DataSize

Nombre d’octets pouvant être lus à partir du membre Data .

u.DeviceHandle.Data[ANYSIZE_ARRAY]

Données binaires facultatives. L’utilisation dépend du contrat de l’EventGuid.

u.DeviceInstance

Examinez cette partie de l’union lorsque le FilterType est CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE.

u.DeviceInstance.InstanceId[ANYSIZE_ARRAY]

L’id de instance de l’appareil auquel se rapportent les données d’événement de notification.

Remarques

Le rappel de notification fourni à CM_Register_Notification reçoit un pointeur vers une structure de type CM_NOTIFY_EVENT_DATA dans le paramètre EventData du rappel.

Configuration requise

En-tête	cfgmgr32.h

Voir aussi

CM_Register_Notification