_DEV_BROADCAST_USERDEFINED structure (dbt.h)

Contient l’événement défini par l’utilisateur et les données facultatives associées à l’événement d’appareil DBT_USERDEFINED .

Syntaxe

struct _DEV_BROADCAST_USERDEFINED {
  struct _DEV_BROADCAST_HDR dbud_dbh;
  char                      dbud_szName[1];
};

Membres

dbud_dbh

Informations sur l’appareil affecté par un message WM_DEVICECHANGE comme spécifié par la structure de DEV_BROADCAST_HDR . Étant donné que _DEV_BROADCAST_USERDEFINED est de longueur variable, le membre dbch_size de la structure dbud_dbh doit être la taille en octets de la structure entière, y compris la partie longueur variable.

dbud_szName[1]

Pointeur vers une chaîne qui respecte la casse et se termine par une valeur Null qui nomme le message. La chaîne doit se composer du nom du fournisseur, une barre oblique inverse, suivie d’un texte arbitraire défini par l’utilisateur qui se termine par une valeur Null.

Remarques

Étant donné que cette structure contient des champs de longueur variable, utilisez-la comme modèle pour créer un pointeur vers une structure définie par l’utilisateur. Notez que la structure ne doit pas contenir de pointeurs. L’exemple suivant montre une telle structure définie par l’utilisateur.

#define NAME_LENGTH 32 
#define USER_LENGTH 50 
 
typedef struct tagWIDGET_WARE_DEV_BROADCAST_USERDEFINED
{
    struct _DEV_BROADCAST_HDR DBHeader; 
    char   szName[NAME_LENGTH];
    BYTE   UserDefined[USER_LENGTH]; 
} WIDGET_WARE_DEV_BROADCAST_USERDEFINED;

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
En-tête	dbt.h

Voir aussi

DBT_USERDEFINED

DEV_BROADCAST_HDR

WM_DEVICECHANGE