BTHHFP_DESCRIPTOR結構（bthhfpddi.h）

發行項
02/06/2025

BTHHFP_DESCRIPTOR數據結構會儲存描述配對的無手配置檔（HFP）裝置的資訊。

HFP 驅動程式會在 IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR 要求的輸出緩衝區中傳回此數據結構。

語法

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

成員

InputPinCategory

配對 HFP 裝置之輸入函式的 KS 針腳類別。

OutputPinCategory

配對 HFP 裝置輸出函式的 KS 針腳類別。

ContainerId

配對 HFP 裝置的 PnP 容器標識碼。

SupportsVolume

指出配對的 HFP 裝置是否支援遠端音量控制。

VolumePropertyValuesSize

如果支援遠端磁碟區控制，此成員會包含 IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES 要求傳回的數據大小。

FriendlyName

識別配對 HFP 裝置之人類可讀取易記名稱的間接字串。

言論

HFP 驅動程式會根據配對裝置 SDP 資訊中包含的「裝置藍牙類別」數據，計算 InputPinCategory 和 OutputPinCategory GUID。音訊驅動程式會設定 KSPIN_DESCRIPTOR。類別輸入與輸出網橋釘選的成員到計算的 GUID。

附注

在某些情況下，輸入和輸出釘選類別可能相同。

音訊驅動程式不應對 InputPinCategory 中傳回的類別 GUID 值進行特定假設，並 OutputPinCategory 成員。音訊系統會使用這項資訊來協助判斷裝置的類型（例如耳機與喇叭），以及是否將裝置用於不同的用途，例如預設通訊裝置。

音訊驅動程式會將 ContainerId 儲存在適當的內容數據中，並在 KSPROPERTY_JACK_CONTAINERID KS 屬性的實作中傳回此值。

如果 SupportsVolume 為 true，音訊驅動程式會在其 KS 拓撲中包含音量支援。

音訊驅動程式會使用 FriendlyName 中所傳回的字串，在 KS 篩選器的KSCATEGORY_AUDIO裝置介面上設定DEVPKEY_DeviceInterface_FriendlyName屬性。若要這樣做，音訊驅動程式會呼叫 IoSetDeviceInterfacePropertyData，並將屬性類型設定為 DEVPROP_TYPE_STRING_INDIRECT。範例字串為「@System32\drivers\bthhfenum.sys，#2;%1 免手%0..;（SomeDeviceName）“ 。請注意，這是間接字串，因此不一定是直接顯示在使用者介面中的人類可讀取字串。音訊系統會使用此字串來產生用於向用戶顯示的當地語系化字串，例如在 [音效] 控制面板中。

如需使用此結構之 IOCTL 的相關信息，請參閱 Bluetooth HFP DDI IOCTLs。