DEVICE_INTERFACE_CHANGE_NOTIFICATION-Struktur (wdm.h)

Artikel
02/27/2024

Die DEVICE_INTERFACE_CHANGE_NOTIFICATION-Struktur beschreibt eine Geräteschnittstelle, die aktiviert (angekommen) oder deaktiviert (entfernt) wurde. Der PnP-Manager sendet diese Struktur an einen Treiber, der eine Rückrufroutine für die Benachrichtigung über EventCategoryDeviceInterfaceChange-Ereignisse registriert hat .

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;

Member

Version

Gibt die Version der Datenstruktur an, derzeit 1.

Size

Gibt die Größe der Struktur in Bytes an, einschließlich der Größe der ersten drei Elemente des Standards und der ereignisspezifischen Daten.

Event

Gibt eine GUID an, die das Ereignis identifiziert: GUID_DEVICE_INTERFACE_ARRIVAL oder GUID_DEVICE_INTERFACE_REMOVAL. Die GUIDs werden in Wdmguid.h definiert.

InterfaceClassGuid

Gibt die Klasse der Geräteschnittstelle an, die gerade aktiviert oder deaktiviert wurde.

SymbolicLinkName

Zeiger auf eine Unicode-Zeichenfolge, die den Namen der symbolischen Verknüpfung für die Geräteschnittstelle enthält.