DEVICE_INTERFACE_CHANGE_NOTIFICATION

The DEVICE_INTERFACE_CHANGE_NOTIFICATION structure describes a device interface that has been enabled (arrived) or disabled (removed). The PnP Manager sends this structure to a driver that registered a callback routine for notification of EventCategoryDeviceInterfaceChange events.

typedef struct _DEVICE_INTERFACE_CHANGE_NOTIFICATION {
  USHORT  Version;
  USHORT  Size;
  GUID  Event;
  //
  // Event-specific data
  //
  GUID  InterfaceClassGuid;
  PUNICODE_STRING  SymbolicLinkName;
} DEVICE_INTERFACE_CHANGE_NOTIFICATION, *PDEVICE_INTERFACE_CHANGE_NOTIFICATION;

Members

Version

Specifies the version of the data structure, currently 1.

Size

Specifies the size of the structure, in bytes, including the size of the standard first three members plus the event-specific data.

Event

Specifies a GUID identifying the event: GUID_DEVICE_INTERFACE_ARRIVAL or GUID_DEVICE_INTERFACE_REMOVAL. The GUIDs are defined in wdmguid.h.

InterfaceClassGuid

Specifies the class of the device interface that has just been enabled or disabled.

SymbolicLinkName

Pointer to a Unicode string that contains the name of the symbolic link for the device interface.

Headers

Defined in wdm.h and ntddk.h. Include wdm.h or ntddk.h.

Comments

This structure is allocated from paged memory.

See Also

HWPROFILE_CHANGE_NOTIFICATION, IoRegisterPlugPlayNotification, PLUGPLAY_NOTIFICATION_HEADER, TARGET_DEVICE_REMOVAL_NOTIFICATION