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 |