PFNBTHPORT_INDICATION_CALLBACK Rückruffunktion (bthddi.h)

Artikel
02/26/2024

Profiltreiber implementieren eine L2CAP-Rückruffunktion, um dem Bluetooth-Treiberstapel einen Mechanismus bereitzustellen, mit dem der Profiltreiber über eingehende L2CAP-Verbindungsanforderungen von Remotegeräten und alle Änderungen am status einer derzeit geöffneten L2CAP-Verbindung benachrichtigt wird.

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 Kontext, der vom Profiltreiber im IndicationCallbackContext-Element des _BRB_L2CA_REGISTER_SERVER Struktur, wenn der Profiltreiber die Rückruffunktion registriert hat. Bei Änderungen an vorhandenen L2CAP-Verbindungen ist dies der CallbackContext-Member , der 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

Keine

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-Elements des _BRB_L2CA_REGISTER_SERVER Struktur. Der Bluetooth-Treiberstapel kann dann den Profiltreiber 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ückrufelements der _BRB_L2CA_OPEN_CHANNEL-Struktur, die übergeben wird, wenn der Profiltreiber einen BRB_L2CA_OPEN_CHANNEL oder sendet. BRB_L2CA_OPEN_CHANNEL_RESPONSE Anforderung.

Nachdem der Profiltreiber seine L2CAP-Rückruffunktion registriert hat, wird 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 im Parameter Parameters enthaltene INDICATION_PARAMETERS-Struktur wird entsprechend dem Wert der INDICATION_CODE-Enumeration interpretiert, den der Bluetooth-Treiberstapel über den Parameter Indication an die L2CAP-Rückruffunktion des Profiltreibers übergibt. Für die meisten Benachrichtigungen gibt es einen INDICATION_PARAMETERS Union-Member, der dem Ereignis entspricht und ereignisspezifische Parameter enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen:_Supported in Windows Vista und höher.
Zielplattform	Desktop
Kopfzeile	bthddi.h (include Bthddi.h)
IRQL	Entwickler sollten diese Funktion so programmieren, dass sie entweder mit IRQL = DISPATCH_LEVEL (wenn die Rückruffunktion nicht auf ausgelagerten Arbeitsspeicher zugreift) oder IRQL = PASSIVE_LEVEL (wenn die Rückruffunktion auf ausgelagerten Arbeitsspeicher zugreifen muss)

Weitere Informationen

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER

Share via