estrutura BTHHFP_DESCRIPTOR (bthhfpddi.h)

Artigo
08/07/2023

A estrutura de dados BTHHFP_DESCRIPTOR armazena informações que descrevem um dispositivo HFP (perfil handsfree) emparelhado.

O driver HFP retorna essa estrutura de dados no buffer de saída para a solicitação de IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR .

Sintaxe

typedef struct _BTHHFP_DESCRIPTOR {
  GUID           InputPinCategory;
  GUID           OutputPinCategory;
  GUID           ContainerId;
  BOOL           SupportsVolume;
  ULONG          VolumePropertyValuesSize;
  UNICODE_STRING FriendlyName;
} BTHHFP_DESCRIPTOR, *PBTHHFP_DESCRIPTOR;

Membros

InputPinCategory

Categoria de pino KS para a função de entrada do dispositivo HFP emparelhado.

OutputPinCategory

Categoria de pino KS para a função de saída do dispositivo HFP emparelhado.

ContainerId

A ID do contêiner PnP para o dispositivo HFP emparelhado.

SupportsVolume

Indica se o dispositivo HFP emparelhado dá suporte ao controle de volume remoto.

VolumePropertyValuesSize

Se houver suporte para o controle de volume remoto, esse membro conterá o tamanho dos dados retornados pela solicitação IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES .

FriendlyName

Uma cadeia de caracteres indireta que identifica o nome amigável legível humano do dispositivo HFP emparelhado.

Comentários

O driver HFP calcula os GUIDs InputPinCategory e OutputPinCategory com base nos dados da "Classe Bluetooth do Dispositivo" contidos nas informações do SDP do dispositivo emparelhado. O driver de áudio define o KSPIN_DESCRIPTOR. Membros de categoria para os pinos de ponte de entrada e saída para os GUIDs calculados.

Observação

Em alguns casos, as categorias de pino de entrada e saída podem ser as mesmas.

O driver de áudio não deve fazer nenhuma suposição específica sobre os valores guid de categoria retornados nos membros InputPinCategory e OutputPinCategory . O sistema de áudio usa essas informações para ajudar a determinar o tipo de dispositivo (por exemplo, fone de ouvido versus alto-falantes) e se deve usar o dispositivo para diferentes finalidades, como o dispositivo de comunicação padrão.

O driver de áudio armazena a ContainerId em dados de contexto apropriados e retorna esse valor em sua implementação da propriedade KS KSPROPERTY_JACK_CONTAINERID .

Se SupportsVolume for true, o driver de áudio incluirá suporte a volume em sua topologia KS.

O driver de áudio usa a cadeia de caracteres retornada em FriendlyName para definir a propriedade DEVPKEY_DeviceInterface_FriendlyName na interface do dispositivo KSCATEGORY_AUDIO do filtro KS. Para fazer isso, o driver de áudio chama IoSetDeviceInterfacePropertyData e define o tipo de propriedade como DEVPROP_TYPE_STRING_INDIRECT. Um exemplo de cadeia de caracteres é "@System32\drivers\bthhfenum.sys,#2;%1 Mãos Livres%0..; (SomeDeviceName)". Observe que essa é uma cadeia de caracteres indireta e, portanto, não necessariamente a cadeia de caracteres legível humana que é exibida diretamente em uma interface do usuário. O sistema de áudio usa essa cadeia de caracteres para gerar cadeias de caracteres localizadas usadas para exibição para o usuário, como no painel de controle Sons.

Para obter informações sobre os IOCTLs que funcionam com essa estrutura, consulte IOCTLs DDI do Bluetooth HFP.