PFNBTHPORT_INDICATION_CALLBACK Rückruffunktion (bthddi.h)

Artikel
02/06/2025

Profiltreiber implementieren eine L2CAP-Rückruffunktion, um den Bluetooth-Treiberstapel mit einem Mechanismus bereitzustellen, um den Profiltreiber über eingehende L2CAP-Verbindungsanforderungen von Remotegeräten und alle Änderungen am Status einer aktuell geöffneten L2CAP-Verbindung zu benachrichtigen.

Syntax

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

void PfnbthportIndicationCallback(
  [in] PVOID Context,
  [in] INDICATION_CODE Indication,
  [in] PINDICATION_PARAMETERS Parameters
)
{...}

Parameter

[in] Context

Für Eingehende Remoteverbindungsanforderungsanzeigen ist dies der vom Profiltreiber im IndicationCallbackContext Mitglied des Profiltreibers angegebene Kontext. _BRB_L2CA_REGISTER_SERVER Struktur, wenn der Profiltreiber die Rückruffunktion registriert hat. Bei Änderungen an vorhandenen L2CAP-Verbindungen ist dies das CallbackContext- Member, das vom Profiltreiber beim Erstellen und Senden eines _BRB_L2CA_OPEN_CHANNEL BRB angegeben wurde.

[in] Indication

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

[in] Parameters

Eine INDICATION_PARAMETERS Struktur, die ereignisspezifische Parameter enthält.

Rückgabewert

Nichts

Bemerkungen

Ein Profiltreiber registriert seine L2CAP-Rückruffunktion in den folgenden beiden Szenarien:

Wenn ein Profiltreiber als Server fungiert, registriert er eine L2CAP-Rückruffunktion mithilfe des IndicationCallback- Mitglieds des _BRB_L2CA_REGISTER_SERVER Struktur. Der Bluetooth-Treiberstapel kann den Profiltreiber dann benachrichtigen, wenn ein Remotegerät versucht, ihn zu kontaktieren.
Wenn der Profiltreiber als Client fungiert und versucht, mithilfe des BRB_L2CA_OPEN_CHANNEL BRB eine Verbindung mit einem Remotegerät herzustellen, registriert der Profiltreiber seine L2CAP-Rückruffunktion mithilfe des Rückrufs Member der _BRB_L2CA_OPEN_CHANNEL-Struktur, die übergeben wird, wenn der Profiltreiber erstellt erstellt und ein BRB_L2CA_OPEN_CHANNEL oder BRB_L2CA_OPEN_CHANNEL_RESPONSE Anforderung.

Nachdem der Profiltreiber seine L2CAP-Rückruffunktion registriert hat, ist die Rückruffunktion nur dem 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 Kanal an das Remotegerät erfolgen. Profiltreiber können eine einzelne Rückruffunktion registrieren, um Kanalbenachrichtigungen als Client- und Verbindungsbenachrichtigungen als Server zu verarbeiten.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Versionen:_Supported in Windows Vista und höher.
Zielplattform-	Desktop
Header-	bthddi.h (include Bthddi.h)
IRQL-	Entwickler sollten diese Funktion codieren, um entweder IRQL = DISPATCH_LEVEL (wenn die Rückruffunktion nicht auf den ausgelagerten Speicher zugreift) oder IRQL = PASSIVE_LEVEL (wenn die Rückruffunktion auf den ausgelagerten Speicher zugreifen muss)

Siehe auch

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER

Freigeben über