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 を送信したときに指定された CallbackContext _BRB_L2CA_OPEN_CHANNEL メンバーです。
[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構造体の コールバック メンバーを使用して、その L2CAP コールバック関数を登録します。 BRB_L2CA_OPEN_CHANNEL_RESPONSE 要求。
Parameters パラメーターに保持されている INDICATION_PARAMETERS 構造体は、Bluetooth ドライバー スタックが Indication パラメーターを介してプロファイル ドライバーの L2CAP コールバック関数に渡す INDICATION_CODE 列挙の値に従って解釈されます。 ほとんどの通知には、イベントに対応し、イベント固有のパラメーターを含むINDICATION_PARAMETERS共用体メンバーがあります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョン:_Supported。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | bthddi.h (Bthddi.h を含む) |
| IRQL | 開発者は、IRQL = DISPATCH_LEVEL (コールバック関数がページング メモリにアクセスしない場合) または IRQL = PASSIVE_LEVEL (コールバック関数がページングされたメモリにアクセスする必要がある場合) で動作するようにこの関数をコーディングする必要があります。 |