_BRB_SCO_REGISTER_SERVER 構造体 (bthddi.h)

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

プロファイルドライバーは、_BRB_SCO_REGISTER_SERVER構造を使用して、リモート Bluetooth デバイスから SCO 接続を受信できるサーバーとして自身を登録します。

構文

struct _BRB_SCO_REGISTER_SERVER {
  BRB_HEADER                 Hdr;
  BTH_ADDR                   BtAddress;
  ULONG                      Reserved;
  ULONG                      IndicationFlags;
  PFNSCO_INDICATION_CALLBACK IndicationCallback;
  PVOID                      IndicationCallbackContext;
  PVOID                      ReferenceObject;
  SCO_SERVER_HANDLE          ServerHandle;
};

メンバー

Hdr

現在の BRB に関する情報を含む BRB_HEADER 構造体。

BtAddress

通知を受信するリモート Bluetooth デバイスのアドレス。

Reserved

将来利用するために予約されています。使用しないでください。

IndicationFlags

IndicationCallback メンバーで指定されたコールバック関数を呼び出すタイミングを示すフラグ。次のフラグが定義されています。

フラグ	説明
SCO_INDICATION_SCO_REQUEST	受信 SCO 接続がある場合は、プロファイルドライバーに通知します。
SCO_INDICATION_ESCO_REQUEST	受信 eSCO 接続がある場合は、プロファイルドライバーに通知します。

IndicationCallback

プロファイルドライバーによって実装される SCO コールバック関数。Bluetooth ドライバースタックが呼び出して、受信 SCO 接続についてプロファイルドライバーに通知する必要があります。

IndicationCallbackContext

IndicationCallback メンバーで定義されている関数に渡されるコンテキスト。

ReferenceObject

参照カウントを維持するために ObReferenceObject 関数と ObDereferenceObject 関数に渡すオブジェクトへのポインター。プロファイルドライバーは、ドライバースタックが IndicationCallback メンバーで指定されたコールバック関数を呼び出すことができる限り、Bluetooth ドライバースタックがオブジェクトの数を増やすように、このオブジェクトを提供する必要があります。プロファイルドライバーがをビルドして送信すると、Bluetooth ドライバースタックによってオブジェクトの参照カウントが減少します。 BRB_SCO_UNREGISTER_SERVER 要求。

ServerHandle

正常に返された場合は、SCO サーバーへのハンドル。プロファイルドライバーがリモート接続の指示を受け取らなくなった場合は、このハンドルをに渡す必要があります BRB_SCO_UNREGISTER_SERVER。

注釈

自身を SCO サーバーとして登録するには、プロファイルドライバーでBRB_SCO_REGISTER_SERVER要求をビルドして送信する必要があります。

成功した場合、Bluetooth ドライバースタックは、リモートデバイスがプロファイルドライバーへの SCO 接続を作成しようとしたときに、プロファイルドライバーに通知できます。

プロファイルドライバー自体が登録されると、Bluetooth ドライバースタックは、プロファイルドライバーが実装し、IndicationCallback メンバーで指定する SCO コールバック関数を呼び出すことによって、リモートデバイスが接続を試みたときに通知できます。

プロファイルドライバーは、接続試行の通知を受け取ると、をビルドして送信する必要があります。 BRB_SCO_OPEN_CHANNEL_RESPONSE 接続の試行を受け入れるか拒否するかを要求します。 SCO 接続試行の受け入れまたは拒否の詳細については、 _BRB_SCO_OPEN_CHANNEL 構造に関するページを参照してください。

接続が確立されると、プロファイルドライバーは他の BRB を発行してリモートデバイスと通信できます。

リモート接続通知の受信を停止するには、プロファイルドライバーでをビルドして送信する必要があります。 BRB_SCO_UNREGISTER_SERVER 要求。