IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)
IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL は、ペアリングされた Handsfree プロファイル (HFP) デバイスに関する説明情報を取得します。
この IOCTL は、Windows 8.1 以降のオペレーティング システムで使用でき、IOCTL_BTHHFP_DEVICE_GET_DESCRIPTORよりも優先されます。
メジャー コード
[入力バッファー]
なし
入力バッファーの長さ
なし
出力バッファー
BTHHFP_DESCRIPTOR2構造体の後に、その構造体によって参照されるその他のデータが続くバッファー。 これは、出力バッファー サイズで十分で要求が成功した場合に当てはまります。 特に、バッファーには、BTHHFP_DESCRIPTOR2構造体の FriendlyName フィールドによって参照される文字列のストレージが含まれます。
出力バッファーの長さ
BTHHFP_DESCRIPTOR2構造体と参照されるデータのサイズ。
ステータス ブロック
ルーチンが成功した場合、Status はSTATUS_SUCCESSに設定され、 Information メンバーはルーチンが出力バッファーに書き込むバイト数です。 出力バッファーには 、BTHHFP_DESCRIPTOR2 構造体によって参照される他のデータが含まれている可能性があるため、これは BTHHFP_DESCRIPTOR2 構造体のサイズよりも大きくなる可能性があることに注意してください。
Status が STATUS_BUFFER_TOO_SMALL に設定されている場合、 Information は呼び出し元がこの要求に割り当てるバッファーのサイズです。
注釈
オーディオ ドライバーは、有効なGUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASSデバイス インターフェイスに関する情報を取得するには、この要求を送信します。 インターフェイスが有効になっている間は情報は変更されませんが、インターフェイスが無効になっている間は変更される可能性があります。 そのため、オーディオ ドライバーは、有効なデバイス インターフェイスを検出した直後にこの要求を送信し、情報を使用して適切なKSFILTER_DESCRIPTOR構造を構築します。
オーディオ ドライバーは、必要な出力バッファー サイズを決定するために、0 の出力バッファー サイズでこの要求を 1 回送信します。 この場合、要求は Status STATUS_BUFFER_TOO_SMALLで完了し、 Information パラメーターには必要なバッファー サイズが含まれます。 その後、オーディオ ドライバーは必要なストレージを割り当て、要求を再度送信します。 通常、オーディオ ドライバーは、後のアクティビティ中に参照できるように、デバイス コンテキストでこのストレージの場所へのポインターを保持します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1 |
| サポートされている最小のサーバー | Windows Server 2012 R2 |
| Header | bthhfpddi.h |