BTHHFP_DESCRIPTOR 結構 (bthhfpddi.h)

發行項
02/22/2024

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 和 OutputPinCategory 成員中傳回的類別 GUID 值做出任何特定假設。音訊系統會使用此資訊來協助判斷裝置類型 (例如，頭戴式裝置與喇叭) ，以及是否要使用裝置做為不同的用途，例如預設通訊裝置。

音訊驅動程式會將 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) ”。請注意，這是間接字串，因此不一定是直接顯示在使用者介面中的人類可讀取字串。音訊系統會使用此字串來產生用於向用戶顯示的當地語系化字串，例如在 [音效] 控制面板中。

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