PFNBTHPORT_INDICATION_CALLBACK_ENHANCED callback function (bthddi.h)

Article
10/21/2021

Profile drivers implement an enhanced L2CAP callback function to provide the Bluetooth driver stack with a mechanism to notify the profile driver about any changes to the status of a currently open L2CAP or eL2CAP connection.

Syntax

PFNBTHPORT_INDICATION_CALLBACK_ENHANCED PfnbthportIndicationCallbackEnhanced;

void PfnbthportIndicationCallbackEnhanced(
  [in] PVOID Context,
  [in] INDICATION_CODE Indication,
  [in] PINDICATION_PARAMETERS_ENHANCED Parameters
)
{...}

Parameters

[in] Context

For changes to existing L2CAP connections, this is the CallbackContext member specified by the profile driver when it built and sent a _BRB_L2CA_OPEN_ENHANCED_CHANNEL structure.

[in] Indication

An INDICATION_CODE value that indicates the type of L2CAP event.

[in] Parameters

An INDICATION_PARAMETERS_ENHANCED structure that contains event-specific parameters.

Return value

None

Remarks

A profile driver registers its L2CAP or eL2CAP callback function by specifying the callback function in the Callback member of the _BRB_L2CA_OPEN_ENHANCED_CHANNEL structure when the profile driver attempts to connect to a remote device using the BRB_L2CA_OPEN_ENHANCED_CHANNEL or BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE BRBs.

After the profile driver registers its L2CAP callback function, the callback function is only associated with the enhanced channel that the BRB opened. The Bluetooth driver stack can call the L2CAP callback function to notify the profile driver of actions that occur over the open enhanced channel to the remote device. Profile drivers can register a single callback function to handle L2CAP channel notifications as a client.

The INDICATION_PARAMETERS_ENHANCED structure held in the Parameters parameter is interpreted according to the value of the INDICATION_CODE enumeration that the Bluetooth driver stack passes to the profile driver's enhanced L2CAP callback function through the Indication parameter. For most notifications, there is an INDICATION_PARAMETERS_ENHANCED union member that corresponds to the event and contains event-specific parameters.

Requirements

Requirement	Value
Minimum supported client	Supported in Windows 8 and later versions of Windows.
Target Platform	Desktop
Header	bthddi.h (include Bthddi.h)

Share via