estrutura _BRB_GET_DEVICE_INTERFACE_STRING (bthddi.h)
A estrutura _BRB_GET_DEVICE_INTERFACE_STRING descreve a cadeia de caracteres da interface do dispositivo para o objeto de dispositivo atual.
Sintaxe
struct _BRB_GET_DEVICE_INTERFACE_STRING {
BRB_HEADER Hdr;
PWCHAR DeviceInterfaceString;
ULONG DeviceInterfaceStringCbLength;
};
Membros
Hdr
Uma estrutura BRB_HEADER que contém informações sobre o BRB atual.
DeviceInterfaceString
Um ponteiro para o buffer para conter a cadeia de caracteres da interface do dispositivo.
DeviceInterfaceStringCbLength
Na entrada, esse membro especifica o comprimento, em bytes, da cadeia de caracteres da interface do dispositivo. Na saída, esse membro especifica o número de bytes necessários para a cadeia de caracteres se o BRB_GET_DEVICE_INTERFACE_STRING O BRB falha e retorna STATUS_MORE_ENTRIES devido ao comprimento insuficiente do buffer. Se a chamada brb for bem-sucedida, esse membro conterá o número de bytes copiados.
Comentários
Para obter a cadeia de caracteres da interface do dispositivo para o objeto de dispositivo atual, os drivers de perfil devem compilar e enviar um BRB_GET_DEVICE_INTERFACE_STRING solicitação.
A pilha de driver Bluetooth executa uma chamada IoRegisterDeviceInterface em cada objeto de dispositivo que ele cria. O BRB retorna a cadeia de caracteres de interface do dispositivo retornada por essa chamada. Isso pode ser útil para registrar-se em eventos.
Se o buffer apontado pelo membro DeviceInterfaceString não for grande o suficiente para manter a cadeia de caracteres, a chamada falhará e o membro DeviceInterfaceStringCbLength conterá o comprimento do buffer necessário.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Versões:_Supported no Windows Vista e posterior. |
| Cabeçalho | bthddi.h (inclua Bthddi.h) |