PFNSCO_INDICATION_CALLBACK コールバック関数 (bthddi.h)

[アーティクル]
02/22/2024

プロファイルドライバーは、リモートデバイスからの受信 SCO 接続要求と、現在開いている SCO 接続の状態に対する変更についてプロファイルドライバーに通知するメカニズムを Bluetooth ドライバースタックに提供する SCO コールバック関数を実装します。

構文

PFNSCO_INDICATION_CALLBACK PfnscoIndicationCallback;

void PfnscoIndicationCallback(
  [in] PVOID Context,
  [in] SCO_INDICATION_CODE Indication,
  [in] PSCO_INDICATION_PARAMETERS Parameters
)
{...}

パラメーター

[in] Context

着信リモート接続要求の表示の場合、これはプロファイルドライバーがコールバック関数を登録したときに、_BRB_SCO_REGISTER_SERVER構造体の IndicationCallbackContext メンバーでプロファイルドライバーによって指定されたコンテキストです。既存の SCO 接続に対する変更の場合、これはプロファイルドライバーが BRB_SCO_OPEN_CHANNEL BRB をビルドして送信したときに指定された CallbackContext メンバーです。

[in] Indication

SCO イベントの種類を示すSCO_INDICATION_CODE値。

[in] Parameters

A SCO_INDICATION_PARAMETERSIndication パラメーターに渡される値に基づくパラメーター情報を格納する構造体です。

戻り値

なし

解説

Parameters パラメーターで渡されるSCO_INDICATION_PARAMETERS構造体にある BtAddress メンバーは、リモートデバイスの Bluetooth アドレスを示します。

PFNSCO_INDICATION_CALLBACK関数は、2 つの方法で登録できます。

最初のケースでは、プロファイルドライバーはサーバーとして機能し、_BRB_SCO_REGISTER_SERVER構造体の IndicationCallback メンバーを介してこのコールバック関数を登録する必要があります。その後、Bluetooth ドライバースタックは、この関数を呼び出して、リモートデバイスがプロファイルドライバーに接続しようとしたときにプロファイルドライバーに通知できます。

2 番目のケースでは、プロファイルドライバーはクライアントとして機能し、 BRB_SCO_OPEN_CHANNEL BRB を使用してリモートデバイスへの接続を試みます。 PFNSCO_INDICATION_CALLBACKコールバック関数は、指定した BRB で渡された_BRB_SCO_OPEN_CHANNEL構造体の Callback メンバーを介して登録されます。その中の 1 つがを介して送信されると、 IOCTL_INTERNAL_BTH_SUBMIT_BRB。

登録後、コールバック関数は BRB が開いたチャネルにのみ関連付けられます。この関数は、開いているチャネルで発生したアクションをプロファイルドライバーにリモートデバイスに通知します。プロファイルドライバーは、チャネル通知をクライアントとして処理し、通知をサーバーとして_BRB_SCO_REGISTER_SERVERする 1 つの関数を登録できます。

Parameters パラメーターに保持されているSCO_INDICATION_PARAMETERS構造体は、Indication パラメーターを介してコールバック関数に渡されるSCO_INDICATION_CODE値に従って解釈されます。ほとんどの通知には、イベントに対応し、イベント固有のパラメーターを含むSCO_INDICATION_PARAMETERS共用体メンバーがあります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョン:_Supported。
対象プラットフォーム	デスクトップ
Header	bthddi.h (Bthddi.h を含む)
IRQL	開発者は、IRQL = DISPATCH_LEVEL (コールバック関数がページメモリにアクセスしない場合)、または IRQL = PASSIVE_LEVEL (コールバック関数がページメモリにアクセスする必要がある場合) で動作するようにこの関数をコーディングする必要があります。