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 |