Share via


estrutura _DEV_BROADCAST_USERDEFINED (dbt.h)

Contém o evento definido pelo usuário e os dados opcionais associados ao evento DBT_USERDEFINED dispositivo.

Sintaxe

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

Membros

dbud_dbh

Informações sobre o dispositivo afetado por uma mensagem WM_DEVICECHANGE conforme especificado pela estrutura DEV_BROADCAST_HDR . Como _DEV_BROADCAST_USERDEFINED é de comprimento variável, o membro dbch_size da estrutura dbud_dbh deve ser o tamanho em bytes de toda a estrutura, incluindo a parte de comprimento variável.

dbud_szName[1]

Um ponteiro para uma cadeia de caracteres terminada em nulo que diferencia maiúsculas de minúsculas que nomeia a mensagem. A cadeia de caracteres deve consistir no nome do fornecedor, uma barra invertida, seguida de texto nulo definido pelo usuário arbitrário.

Comentários

Como essa estrutura contém campos de comprimento variável, use-a como um modelo para criar um ponteiro para uma estrutura definida pelo usuário. Observe que a estrutura não deve conter ponteiros. O exemplo a seguir mostra essa estrutura definida pelo usuário.

#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;

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho dbt.h

Confira também

DBT_USERDEFINED

DEV_BROADCAST_HDR

WM_DEVICECHANGE