PFNBTHPORT_INDICATION_CALLBACK_ENHANCED Rückruffunktion (bthddi.h)

Profiltreiber implementieren eine erweiterte L2CAP-Rückruffunktion, um den Bluetooth-Treiberstapel mit einem Mechanismus bereitzustellen, um den Profiltreiber über änderungen am Status einer aktuell geöffneten L2CAP- oder eL2CAP-Verbindung zu benachrichtigen.

Syntax

PFNBTHPORT_INDICATION_CALLBACK_ENHANCED PfnbthportIndicationCallbackEnhanced;

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

Parameter

[in] Context

Bei Änderungen an vorhandenen L2CAP-Verbindungen ist dies das CallbackContext-element, das vom Profiltreiber beim Erstellen und Senden einer _BRB_L2CA_OPEN_ENHANCED_CHANNEL-Struktur angegeben wurde.

[in] Indication

Ein INDICATION_CODE Wert, der den Typ des L2CAP-Ereignisses angibt.

[in] Parameters

Eine INDICATION_PARAMETERS_ENHANCED Struktur, die ereignisspezifische Parameter enthält.

Rückgabewert

Nichts

Bemerkungen

Ein Profiltreiber registriert seine L2CAP- oder eL2CAP-Rückruffunktion, indem die Rückruffunktion im Callback-element _BRB_L2CA_OPEN_ENHANCED_CHANNEL Struktur angegeben wird, wenn der Profiltreiber versucht, mithilfe der BRB_L2CA_OPEN_ENHANCED_CHANNEL oder BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE BRBs eine Verbindung mit einem Remotegerät herzustellen.

Nachdem der Profiltreiber seine L2CAP-Rückruffunktion registriert hat, ist die Rückruffunktion nur dem erweiterten Kanal zugeordnet, den der BRB geöffnet hat. Der Bluetooth-Treiberstapel kann die L2CAP-Rückruffunktion aufrufen, um den Profiltreiber über Aktionen zu benachrichtigen, die über den geöffneten erweiterten Kanal an das Remotegerät auftreten. Profiltreiber können eine einzelne Rückruffunktion registrieren, um L2CAP-Kanalbenachrichtigungen als Client zu behandeln.

Die INDICATION_PARAMETERS_ENHANCED Struktur in der Parameters Parameter wird gemäß dem Wert der INDICATION_CODE Enumeration interpretiert, die der Bluetooth-Treiberstapel über die Indication Parameter an die erweiterte L2CAP-Rückruffunktion des Profiltreibers übergibt. Für die meisten Benachrichtigungen gibt es ein INDICATION_PARAMETERS_ENHANCED Union-Mitglied, das dem Ereignis entspricht und ereignisspezifische Parameter enthält.

Anforderungen