次の方法で共有

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

  • [アーティクル]

オーディオ ドライバーは、有効なGUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASSデバイス インターフェイスに関する情報を取得する IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR コントロール コードを発行します。

注 この IOCTL は、非推奨になった IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES と IOCTL_BTHHFP_DEVICE_GET_CONTAINERID よりも優先されます。
 

メジャー コード

IRP_MJ_DEVICE_CONTROL

入力バッファー

何一つ。

入力バッファーの長さ

何一つ。

出力バッファー

BTHHFP_DESCRIPTOR 構造体の後に、その構造体によって参照されるその他のデータが続くバッファー。 これは、出力バッファー サイズが十分で、要求が成功した場合に当てはまります。 特に、バッファーには、BTHHFP_DESCRIPTOR 構造体の FriendlyName フィールドによって参照される文字列のストレージが含まれます。

出力バッファーの長さ

BTHHFP_DESCRIPTOR 構造体と参照されるデータのサイズ。

状態ブロック

ルーチンが成功した場合、Status はSTATUS_SUCCESSに設定され、Information メンバーは、ルーチンが出力バッファーに書き込むバイト数です。

注 出力バッファーには構造体によって参照される他のデータが含まれている可能性があるため、これは BTHHFP_DESCRIPTOR 構造体のサイズよりも大きくなる可能性があります。
 
Status が STATUS_BUFFER_TOO_SMALL に設定されている場合、オーディオ ドライバーは、情報 メンバーを読み取って、呼び出し元がこの要求に割り当てるバッファーのサイズを取得する必要があります。

備考

オーディオ ドライバーは、有効なGUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASSデバイス インターフェイスに関する情報を取得するために、この要求を送信します。 インターフェイスが有効になっている間は情報は変更されませんが、インターフェイスが無効になっている間は変更される可能性があります。 そのため、オーディオ ドライバーは、有効なデバイス インターフェイスを検出した直後にこの要求を送信し、情報を使用して適切なKSFILTER_DESCRIPTOR構造を構築します。

オーディオ ドライバーは、必要な出力バッファー サイズを決定するために、0 の出力バッファー サイズでこの要求を 1 回送信します。 この場合、要求は Status STATUS_BUFFER_TOO_SMALL で完了し、Information メンバーを必要なバッファー サイズに設定します。 その後、オーディオ ドライバーは必要な記憶域を割り当て、要求を再度送信します。 通常、オーディオ ドライバーは、後のアクティビティ中に参照できるように、デバイス コンテキストにこの記憶域の場所へのポインターを格納します。

必要条件

要件 価値
サポートされる最小クライアント Windows 8
サポートされる最小サーバー Windows Server 2012
ヘッダー bthhfpddi.h

関連項目

Bluetooth HFP DDI IOCTL を する

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES