CM_NOTIFY_EVENT_DATA Struktur (cfgmgr32.h)

Dies ist eine Datenstruktur für Gerätebenachrichtigungsereignisse.

Syntax

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;

Member

FilterType

Die CM_NOTIFY_FILTER_TYPE aus der CM_NOTIFY_FILTER-Struktur , die in der Registrierung verwendet wurde, die diese Benachrichtigungsereignisdaten generiert hat.

Reserved

Reserviert. Muss den Wert 0 (null) haben.

u

Eine Union, die Informationen zu den Benachrichtigungsereignisdaten enthält. Um zu bestimmen, welches Element der Union untersucht werden soll, überprüfen Sie den FilterType der Ereignisdaten.

u.DeviceInterface

Untersuchen Sie diesen Teil der Union, wenn filterTypeCM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE ist.

u.DeviceInterface.ClassGuid

Die GUID der Geräteschnittstellenklasse für die Geräteschnittstelle, auf die sich die Benachrichtigungsereignisdaten beziehen.

u.DeviceInterface.SymbolicLink[ANYSIZE_ARRAY]

Der symbolische Linkpfad der Geräteschnittstelle, auf die sich die Benachrichtigungsereignisdaten beziehen.

u.DeviceHandle

Untersuchen Sie diesen Teil der Union, wenn filterTypeCM_NOTIFY_FILTER_TYPE_DEVICEHANDLE und die Benachrichtigungsaktion CM_NOTIFY_ACTION_DEVICECUSTOMEVENT wird.

u.DeviceHandle.EventGuid

Die GUID für das benutzerdefinierte Ereignis.

u.DeviceHandle.NameOffset

Der Offset eines optionalen Zeichenfolgenpuffers. Die Nutzung hängt vom Vertrag für die EventGuid ab.

u.DeviceHandle.DataSize

Die Anzahl der Bytes, die aus dem Data-Member gelesen werden können.

u.DeviceHandle.Data[ANYSIZE_ARRAY]

Optionale Binärdaten. Die Nutzung hängt vom Vertrag für die EventGuid ab.

u.DeviceInstance

Untersuchen Sie diesen Teil der Union, wenn filterTypeCM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE ist.

u.DeviceInstance.InstanceId[ANYSIZE_ARRAY]

Das Gerät instance ID des Geräts, auf das sich die Benachrichtigungsereignisdaten beziehen.

Hinweise

Der für CM_Register_Notification bereitgestellte Benachrichtigungsrückruf empfängt einen Zeiger auf eine Struktur vom Typ CM_NOTIFY_EVENT_DATA im EventData-Parameter des Rückrufs.

Anforderungen

Kopfzeile	cfgmgr32.h

Weitere Informationen

CM_Register_Notification