BTHHFP_DESCRIPTOR estrutura (bthhfpddi.h)

Artigo
02/06/2025

A estrutura de dados BTHHFP_DESCRIPTOR armazena informações que descrevem um dispositivo HFP (perfil livre de mãos) 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.

Observações

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

de Observação

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

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

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

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 no 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. Uma cadeia de caracteres de exemplo é "@System32\drivers\bthhfenum.sys,#2;%1%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 de IOCTLs DDI bluetooth HFP.