BTH_VENDOR_SPECIFIC_COMMAND Struktur (bthioctl.h)

Die BTH_VENDOR_SPECIFIC_COMMAND-Struktur gibt einen bluetooth-spezifischen 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;

Angehörige

ManufacturerId

Der Herstellerbezeichner des Funkgeräts. Radios mit diesem Herstellerbezeichner 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 Radio gesendet. Andernfalls empfängt das Radio nicht den Befehl. Wenn LmpVersion null ist, erhalten alle Radios den anbieterspezifischen Befehl.

MatchAnySinglePattern

Ein BOOLESCHER Wert, der angibt, ob alle Muster im Data Member übereinstimmen müssen, oder nur ein Muster muss übereinstimmen, um ein Ereignis einem anbieterspezifischen Befehl zuzuordnen. Wenn keine Muster vorhanden sind, die einem anbieterspezifischen Befehl zugeordnet sind, wird dieses Element ignoriert. Wenn MatchAnySinglePatternFALSE-ist, müssen alle Muster übereinstimmen, um dem Befehl ein Ereignis zuzuordnen. Wenn MatchAnySinglePattern-TRUE-ist, ordnet ein beliebiges Muster dem Befehl zu.

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 Radio gesendet werden sollen. Sie sollte nicht die Größe der Muster enthalten.

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.

Bemerkungen

Diese BTH_VENDOR_SPECIFIC_COMMAND Struktur gibt den Eingabepuffer für den IOCTL_BTH_HCI_VENDOR_COMMAND IOCTL. Diese IOCTL kann verwendet werden, um herstellerspezifische Befehle an Bluetooth-Radios zu senden.

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

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

Wenn Muster erforderlich sind, folgen die Muster den Daten, die im Data Memberpuffer an das Funkgerät 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

Siehe auch

BTH_COMMAND_HEADER

BTH_VENDOR_PATTERN

IOCTL_BTH_HCI_VENDOR_COMMAND