BTH_VENDOR_SPECIFIC_COMMAND-Struktur (bthioctl.h)

Artikel
02/22/2024

Die BTH_VENDOR_SPECIFIC_COMMAND-Struktur gibt einen herstellerspezifischen Bluetooth-Befehl an.

Syntax

typedef struct _BTH_VENDOR_SPECIFIC_COMMAND {
  ULONG              ManufacturerId;
  UCHAR              LmpVersion;
  BOOLEAN            MatchAnySinglePattern;
  BTH_COMMAND_HEADER HciHeader;
  UCHAR              Data[1];
} BTH_VENDOR_SPECIFIC_COMMAND, *PBTH_VENDOR_SPECIFIC_COMMAND;

Member

ManufacturerId

Der Herstellerbezeichner des Funkgeräts. Funkgeräte, die über diesen Herstellerbezeichner verfügen, können den herstellerspezifischen Befehl empfangen.

LmpVersion

Eine UCHAR, die die LMP-Version (Link Management Protocol) enthält. Wenn die LMP-Version eines Funkgeräts größer als dieser Wert ist, wird der Befehl an das Funkgerät gesendet. Andernfalls empfängt das Funkgerät den Befehl nicht. Wenn LmpVersion null ist, erhalten alle Funkgeräte den anbieterspezifischen Befehl.

MatchAnySinglePattern

Ein BOOLEAN-Wert, der angibt, ob alle Muster im Data-Member übereinstimmen müssen oder nur ein Muster übereinstimmen muss, um einem anbieterspezifischen Befehl ein Ereignis zuzuordnen. Wenn es keine Muster gibt, die einem anbieterspezifischen Befehl zugeordnet sind, wird dieser Member ignoriert. Wenn MatchAnySinglePatternauf FALSE festgelegt ist, müssen alle Muster übereinstimmen, um dem Befehl ein Ereignis zuzuordnen. Wenn MatchAnySinglePatternauf TRUE festgelegt ist, wird dem Befehl ein Ereignis mit einem beliebigen Muster zugeordnet.

HciHeader

Eine BTH_COMMAND_HEADER-Struktur , die Informationen zum anbieterspezifischen Befehl enthält, der einen Vorgangscode und eine Pufferlänge enthält. Die Pufferlänge sollte nur die Größe der Daten enthalten, die an das Funkgerät gesendet werden sollen. Die Größe der Muster sollte nicht enthalten sein.

Data[1]

Ein UCHAR-Array, das die Daten und Muster für den Befehl enthält, der im HciHeader-Member angegeben ist. Muster werden mit BTH_VENDOR_PATTERN-Strukturen angegeben.

Hinweise

Diese BTH_VENDOR_SPECIFIC_COMMAND-Struktur gibt den Eingabepuffer für die IOCTL_BTH_HCI_VENDOR_COMMAND IOCTL. Diese IOCTL kann verwendet werden, um anbieterspezifische Befehle an Bluetooth-Funkgeräte zu senden.

Um die Größe der HCI-Befehlsdaten anzugeben, verwenden Sie das TotalParameterLength-Element in der BTH_COMMAND_HEADER-Struktur im HciHeader-Element der BTH_VENDOR_SPECIFIC_COMMAND-Struktur.

Muster sind erforderlich, wenn ein anbieterspezifischer Befehl nicht der standardmäßigen HCI-Flusssteuerung folgt und als Reaktion auf den anbieterspezifischen Befehl ein anbieterspezifisches Ereignis generiert wird.

Wenn Muster erforderlich sind, folgen die Muster den Daten, die an das Funkgerät im Datenmemberpuffer gesendet werden sollen. Jedes Muster beginnt mit einer BTH_VENDOR_PATTERN-Struktur .

Wenn solche Muster angegeben werden, sollte das TotalParameterLength-Element nicht die Größe der Muster enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen: _Available in Windows Vista und höheren Versionen von Windows.
Kopfzeile	bthioctl.h (einschließlich Bthioctl.h)

Weitere Informationen

BTH_COMMAND_HEADER

BTH_VENDOR_PATTERN

IOCTL_BTH_HCI_VENDOR_COMMAND

Freigeben über