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 コールバック関数を登録します。
- プロファイル ドライバーは、サーバーとして機能する場合、 の IndicationCallback メンバーを使用して L2CAP コールバック関数を登録します。 _BRB_L2CA_REGISTER_SERVER 構造体。 その後、Bluetooth ドライバー スタックは、リモート デバイスがプロファイル ドライバーに接続しようとしたときに、プロファイル ドライバーに通知できます。
- プロファイル ドライバーがクライアントとして機能し、BRB_L2CA_OPEN_CHANNEL BRB を使用してリモート デバイスに接続しようとすると、プロファイル ドライバーは、プロファイル ドライバーが BRB_L2CA_OPEN_CHANNEL をビルドして送信するときに渡される_BRB_L2CA_OPEN_CHANNEL構造体の Callback メンバーを使用して、その L2CAP コールバック関数を登録します。 BRB_L2CA_OPEN_CHANNEL_RESPONSE 要求。
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 (コールバック関数がページメモリにアクセスする必要がある場合) で動作するようにこの関数をコーディングする必要があります。 |