共用方式為


BTHHFP_DESCRIPTOR 結構 (bthhfpddi.h)

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 資訊中包含的「裝置藍牙類別」數據,計算 InputPinCategoryOutputPinCategory GUID。 音訊驅動程式會設定 KSPIN_DESCRIPTOR。 輸入和輸出網橋釘選到導出 GUID 的類別成員。

注意  

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

音訊驅動程序應該不會對 InputPinCategoryOutputPinCategory 成員中傳回的類別 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

規格需求

需求
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
標頭 bthhfpddi.h

另請參閱

藍牙 HFP DDI IOCTLs

藍牙 HFP DDI 結構

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR

IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES

KSPIN_DESCRIPTOR。類別

KSPROPERTY_JACK_CONTAINERID