_BRB_SCO_REGISTER_SERVER Struktur (bthddi.h)

Ein Profiltreiber verwendet die _BRB_SCO_REGISTER_SERVER Struktur, um sich selbst als Server zu registrieren, der SCO-Verbindungen von Remote-Bluetooth-Geräten empfangen kann.

Syntax

struct _BRB_SCO_REGISTER_SERVER {
  BRB_HEADER                 Hdr;
  BTH_ADDR                   BtAddress;
  ULONG                      Reserved;
  ULONG                      IndicationFlags;
  PFNSCO_INDICATION_CALLBACK IndicationCallback;
  PVOID                      IndicationCallbackContext;
  PVOID                      ReferenceObject;
  SCO_SERVER_HANDLE          ServerHandle;
};

Angehörige

Hdr

Eine BRB_HEADER Struktur, die Informationen zum aktuellen BRB enthält.

BtAddress

Die Adresse des Remote-Bluetooth-Geräts, für das Benachrichtigungen empfangen werden sollen.

Reserved

Reserviert für die zukünftige Verwendung. Nicht verwenden.

IndicationFlags

Ein Flag, das angibt, wann die Rückruffunktion, die im IndicationCallback Member angegeben ist, aufgerufen werden soll. Die folgenden Flags werden definiert.

IndicationCallback

Eine SCO Callback Function, implementiert vom Profiltreiber, dass der Bluetooth-Treiberstapel aufgerufen werden soll, um den Profiltreiber über eingehende SCO-Verbindungen zu benachrichtigen.

IndicationCallbackContext

Der Kontext, der an die Funktion übergeben wird, die im IndicationCallback Member definiert ist.

ReferenceObject

Ein Zeiger auf ein Objekt, das an das ObReferenceObject übergeben werden soll, und ObDereferenceObject- Funktionen, um die Referenzanzahl beizubehalten. Profiltreiber sollten dieses Objekt so bereitstellen, dass der Bluetooth-Treiberstapel die Anzahl des Objekts erhöhen kann, solange der Treiberstapel die rückruffunktion aufrufen kann, die im IndicationCallback Member angegeben ist. Der Bluetooth-Treiberstapel verringert die Referenzanzahl des Objekts, wenn der Profiltreiber Builds erstellt und BRB_SCO_UNREGISTER_SERVER Anforderung.

ServerHandle

Behandeln Sie den SCO-Server, wenn er erfolgreich zurückgegeben wurde. Wenn der Profiltreiber keine Remoteverbindungsanzeigen mehr empfangen sollte, sollte dieses Handle an BRB_SCO_UNREGISTER_SERVER.

Bemerkungen

Um sich selbst als SCO-Server zu registrieren, sollte ein Profiltreiber erstellen und eine BRB_SCO_REGISTER_SERVER Anforderung senden.

Bei erfolgreicher Ausführung kann der Bluetooth-Treiberstapel den Profiltreiber benachrichtigen, wenn Remotegeräte versuchen, eine SCO-Verbindung mit dem Profiltreiber zu erstellen.

Nachdem sich der Profiltreiber selbst registriert hat, kann der Bluetooth-Treiberstapel es benachrichtigen, wenn ein Remotegerät versucht, eine Verbindung mit ihm herzustellen, indem er die SCO Callback Function aufruft, die der Profiltreiber implementiert und im IndicationCallback Member angibt.

Wenn der Profiltreiber eine Benachrichtigung über einen Verbindungsversuch empfängt, sollte er erstellen und BRB_SCO_OPEN_CHANNEL_RESPONSE Anforderung, den Verbindungsversuch zu akzeptieren oder abzulehnen. Weitere Informationen zum Akzeptieren oder Ablehnen von SCO-Verbindungsversuchen finden Sie in der _BRB_SCO_OPEN_CHANNEL Struktur.

Nachdem eine Verbindung hergestellt wurde, kann der Profiltreiber andere BRBs ausgeben, um mit dem Remotegerät zu kommunizieren.

Um den Empfang von Remoteverbindungsbenachrichtigungen zu beenden, sollte ein Profiltreiber erstellen und BRB_SCO_UNREGISTER_SERVER Anforderung.

Anforderungen

Siehe auch

BRB_HEADER

BRB_SCO_REGISTER_SERVER

BRB_SCO_UNREGISTER_SERVER

ObDereferenceObject

ObReferenceObject-

SCO-Rückruffunktion