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 GUID と 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 の詳細については、「 Bluetooth HFP DDI IOCTL」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| サポートされている最小のサーバー | Windows Server 2012 |
| Header | bthhfpddi.h |
こちらもご覧ください
IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR