structure DEVICE_INTERFACE_CHANGE_NOTIFICATION (wdm.h)

  • Article

La structure DEVICE_INTERFACE_CHANGE_NOTIFICATION décrit une interface d’appareil qui a été activée (arrivée) ou désactivée (supprimée). Le gestionnaire PnP envoie cette structure à un pilote qui a inscrit une routine de rappel pour la notification des événements EventCategoryDeviceInterfaceChange .

Syntaxe

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;

Membres

Version

Spécifie la version de la structure de données, actuellement 1.

Size

Spécifie la taille de la structure, en octets, y compris la taille des trois premiers membres standard plus les données spécifiques à l’événement.

Event

Spécifie un GUID identifiant l’événement : GUID_DEVICE_INTERFACE_ARRIVAL ou GUID_DEVICE_INTERFACE_REMOVAL. Les GUID sont définis dans Wdmguid.h.

InterfaceClassGuid

Spécifie la classe de l’interface de l’appareil qui vient d’être activée ou désactivée.

SymbolicLinkName

Pointeur vers une chaîne Unicode qui contient le nom du lien symbolique pour l’interface de l’appareil.

Remarques

Cette structure est allouée à partir de la mémoire paginée.

Configuration requise

Condition requise Valeur
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

HWPROFILE_CHANGE_NOTIFICATION

IoRegisterPlugPlayNotification

PLUGPLAY_NOTIFICATION_HEADER

TARGET_DEVICE_REMOVAL_NOTIFICATION