DEVICE_INTERFACE_CHANGE_NOTIFICATION structure (wdm.h)

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.

Syntax

typedef struct _DEVICE_INTERFACE_CHANGE_NOTIFICATION {
  USHORT          Version;
  USHORT          Size;
  GUID            Event;
  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.

Remarks

This structure is allocated from paged memory.

Requirements

Requirement Value
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

See also

HWPROFILE_CHANGE_NOTIFICATION

IoRegisterPlugPlayNotification

PLUGPLAY_NOTIFICATION_HEADER

TARGET_DEVICE_REMOVAL_NOTIFICATION