BTHHFP_DESCRIPTOR 構造体 (bthhfpddi.h)

[アーティクル]
08/07/2023

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 値について、特に想定しないでください。オーディオシステムは、この情報を使用して、デバイスの種類 (ヘッドセットとスピーカーなど) と、既定の通信デバイスなどのさまざまな目的でデバイスを使用するかどうかを判断するのに役立ちます。

オーディオドライバーは、適切なコンテキストデータに 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 IOCTL」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
Header	bthhfpddi.h