次の方法で共有

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

  • [アーティクル]

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

構文

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

void PfnbthportIndicationCallback(
  [in] PVOID Context,
  [in] INDICATION_CODE Indication,
  [in] PINDICATION_PARAMETERS Parameters
)
{...}

パラメーター

[in] Context

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

[in] Indication

L2CAP イベントの種類を示すINDICATION_CODE値。

[in] Parameters

イベント固有のパラメーターを含む INDICATION_PARAMETERS 構造体。

戻り値

なし

解説

プロファイル ドライバーは、次の 2 つのシナリオで L2CAP コールバック関数を登録します。

  1. プロファイル ドライバーは、サーバーとして機能する場合、 の IndicationCallback メンバーを使用して L2CAP コールバック関数を登録します。 _BRB_L2CA_REGISTER_SERVER 構造体。 その後、Bluetooth ドライバー スタックは、リモート デバイスがプロファイル ドライバーに接続しようとしたときに、プロファイル ドライバーに通知できます。
  2. プロファイル ドライバーがクライアントとして機能し、BRB_L2CA_OPEN_CHANNEL BRB を使用してリモート デバイスに接続しようとすると、プロファイル ドライバーは、プロファイル ドライバーが BRB_L2CA_OPEN_CHANNEL をビルドして送信するときに渡される_BRB_L2CA_OPEN_CHANNEL構造体の Callback メンバーを使用して、その L2CAP コールバック関数を登録します。 BRB_L2CA_OPEN_CHANNEL_RESPONSE 要求。
プロファイル ドライバーが L2CAP コールバック関数を登録すると、コールバック関数は BRB が開いたチャネルにのみ関連付けられます。 Bluetooth ドライバー スタックは、L2CAP コールバック関数を呼び出して、開いているチャネルを介してリモート デバイスに対して発生するアクションをプロファイル ドライバーに通知できます。 プロファイル ドライバーは、単一のコールバック関数を登録して、チャネル通知をクライアントとして処理し、接続通知をサーバーとして処理できます。

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

要件

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

こちらもご覧ください

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER