struttura CM_NOTIFY_EVENT_DATA (cfgmgr32.h)

Articolo
08/22/2023

Si tratta di una struttura dei dati degli eventi di notifica del dispositivo.

Sintassi

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;

Members

FilterType

Il CM_NOTIFY_FILTER_TYPE dalla struttura CM_NOTIFY_FILTER utilizzata nella registrazione che ha generato i dati dell'evento di notifica.

Reserved

Riservato. Deve essere 0.

u

Unione che contiene informazioni sui dati dell'evento di notifica. Per determinare quale membro dell'unione esaminare, controllare il filterType dei dati dell'evento.

u.DeviceInterface

Esaminare questa parte dell'unione quando filterType è CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE.

u.DeviceInterface.ClassGuid

GUID della classe dell'interfaccia del dispositivo per l'interfaccia del dispositivo a cui sono relativi i dati dell'evento di notifica.

u.DeviceInterface.SymbolicLink[ANYSIZE_ARRAY]

Percorso di collegamento simbolico dell'interfaccia del dispositivo a cui sono relativi i dati dell'evento di notifica.

u.DeviceHandle

Esaminare questa parte dell'unione quando FilterType è CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE e l'azione di notifica viene CM_NOTIFY_ACTION_DEVICECUSTOMEVENT.

u.DeviceHandle.EventGuid

GUID per l'evento personalizzato.

u.DeviceHandle.NameOffset

Offset di un buffer stringa facoltativo. L'utilizzo dipende dal contratto per EventGuid.

u.DeviceHandle.DataSize

Numero di byte che possono essere letti dal membro Dati .

u.DeviceHandle.Data[ANYSIZE_ARRAY]

Dati binari facoltativi. L'utilizzo dipende dal contratto per EventGuid.

u.DeviceInstance

Esaminare questa parte dell'unione quando filterType è CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE.

u.DeviceInstance.InstanceId[ANYSIZE_ARRAY]

ID dell'istanza del dispositivo a cui sono relativi i dati dell'evento di notifica.

Commenti

Il callback di notifica fornito a CM_Register_Notification riceve un puntatore a una struttura di tipo CM_NOTIFY_EVENT_DATA nel parametro EventData del callback.

Requisiti


Intestazione	cfgmgr32.h

Vedi anche

CM_Register_Notification

Condividi tramite