BTHHFP_DESCRIPTOR構造体 (bthhfpddi.h)
BTHHFP_DESCRIPTOR データ構造には、ペアリングされた Handsfree プロファイル (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 コンテナー ID。
SupportsVolume
ペアリングされた HFP デバイスがリモート ボリューム制御をサポートしているかどうかを示します。
VolumePropertyValuesSize
リモート・ボリューム制御がサポートされている場合、このメンバーには、IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES 要求によって返されるデータのサイズが含まれます。
FriendlyName
ペアリングされた HFP デバイスの人間が判読できるフレンドリ名を識別する間接文字列。
備考
HFP ドライバーは、ペアリングされたデバイスの SDP 情報に含まれる "Bluetooth Class of Device" データに基づいて、InputPinCategoryと outputPinCategory GUID を計算します。 オーディオ ドライバーは、KSPIN_DESCRIPTOR を設定します。カテゴリ、計算された GUID への入力および出力ブリッジ ピンのメンバーです。
場合によっては、入力ピンと出力ピンのカテゴリが同じになることがあります。
オーディオ ドライバーは、InputPinCategory および OutputPinCategory メンバー 返されるカテゴリ GUID 値について、特に想定しないでください。 オーディオ システムは、この情報を使用して、デバイスの種類 (ヘッドセットとスピーカーなど) と、既定の通信デバイスなどのさまざまな目的でデバイスを使用するかどうかを判断するのに役立ちます。
SupportsVolume が true の場合、オーディオ ドライバーは KS トポロジにボリューム サポートを含めます。
オーディオ ドライバーは、FriendlyName で返される文字列を使用して、KS フィルターのKSCATEGORY_AUDIO デバイス インターフェイスにDEVPKEY_DeviceInterface_FriendlyNameプロパティを設定します。 これを行うために、オーディオ ドライバーは IoSetDeviceInterfacePropertyData を呼び出し、プロパティの種類をDEVPROP_TYPE_STRING_INDIRECTに設定します。 文字列の例は "@System32\drivers\bthhfenum.sys,#2; です。%1 ハンズフリー%0..;(SomeDeviceName)"。 これは間接的な文字列であるため、ユーザー インターフェイスに直接表示される人間が判読できる文字列であるとは限らないことに注意してください。 オーディオ システムでは、この文字列を使用して、サウンド コントロール パネルなど、ユーザーに表示するために使用されるローカライズされた文字列を生成します。
この構造体で動作する IOCTL の詳細については、HFP DDI IOCTL Bluetoothを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 |
| サポートされる最小サーバー | Windows Server 2012 |
| ヘッダー | bthhfpddi.h |
関連項目
Bluetooth HFP DDI IOCTL を する
IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR