estrutura DEV_BROADCAST_DEVICEINTERFACE_A (dbt.h)

Artigo
02/29/2024

Contém informações sobre uma classe de dispositivos.

Sintaxe

typedef struct _DEV_BROADCAST_DEVICEINTERFACE_A {
  DWORD dbcc_size;
  DWORD dbcc_devicetype;
  DWORD dbcc_reserved;
  GUID  dbcc_classguid;
  char  dbcc_name[1];
} DEV_BROADCAST_DEVICEINTERFACE_A, *PDEV_BROADCAST_DEVICEINTERFACE_A;

Membros

dbcc_size

O tamanho dessa estrutura, em bytes. Esse é o tamanho dos membros mais o comprimento real da cadeia de caracteres dbcc_name (o caractere nulo é contabilizado pela declaração de dbcc_name como uma matriz de um caractere.)

dbcc_devicetype

Defina como DBT_DEVTYP_DEVICEINTERFACE.

dbcc_reserved

Reservado; não use.

dbcc_classguid

O GUID para a classe de dispositivo de interface.

dbcc_name[1]

Uma cadeia de caracteres terminada em nulo que especifica o nome do dispositivo.

Quando essa estrutura é retornada para uma janela por meio da mensagem WM_DEVICECHANGE , a cadeia de caracteres dbcc_name é convertida em ANSI conforme apropriado. Os serviços sempre recebem uma cadeia de caracteres Unicode, quer chamem RegisterDeviceNotificationW ou RegisterDeviceNotificationA.

Comentários

Observação

O cabeçalho dbt.h define DEV_BROADCAST_DEVICEINTERFACE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.