PFNBTHPORT_INDICATION_CALLBACK_ENHANCED Rückruffunktion (bthddi.h)

Artikel
02/26/2024

Profiltreiber implementieren eine erweiterte L2CAP-Rückruffunktion, um dem Bluetooth-Treiberstapel einen Mechanismus bereitzustellen, mit dem der Profiltreiber über änderungen am status einer derzeit geöffneten L2CAP- oder eL2CAP-Verbindung informiert wird.

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 der CallbackContext-Member , der 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

Keine

Bemerkungen

Ein Profiltreiber registriert seine L2CAP- oder eL2CAP-Rückruffunktion, indem er die Rückruffunktion im Rückrufelement der _BRB_L2CA_OPEN_ENHANCED_CHANNEL-Struktur angibt, 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, wird 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 erfolgen. Profiltreiber können eine einzelne Rückruffunktion registrieren, um L2CAP-Kanalbenachrichtigungen als Client zu verarbeiten.

Die im Parameter Parameters enthaltene INDICATION_PARAMETERS_ENHANCED-Struktur wird entsprechend dem Wert der INDICATION_CODE-Enumeration interpretiert, die der Bluetooth-Treiberstapel über den Parameter Indication an die erweiterte L2CAP-Rückruffunktion des Profiltreibers übergibt. Für die meisten Benachrichtigungen gibt es einen INDICATION_PARAMETERS_ENHANCED Union-Member, der dem Ereignis entspricht und ereignisspezifische Parameter enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in Windows 8 und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	bthddi.h (include Bthddi.h)

Share via