BTH_VENDOR_SPECIFIC_COMMAND structure (bthioctl.h)

La structure BTH_VENDOR_SPECIFIC_COMMAND spécifie une commande spécifique au fournisseur Bluetooth.

Syntaxe

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;

Membres

ManufacturerId

Identificateur du fabricant de la radio. Les radios qui ont cet identificateur de fabricant peuvent recevoir la commande propre au fournisseur.

LmpVersion

UCHAR qui contient la version du protocole de gestion des liens (LMP). Si la version LMP d’une radio est supérieure à cette valeur, la commande est envoyée à la radio. Sinon, la radio ne reçoit pas la commande . Si LmpVersion est égal à zéro, toutes les radios reçoivent la commande propre au fournisseur.

MatchAnySinglePattern

Valeur BOOLEAN qui spécifie si tous les modèles dans le membre Data doivent correspondre ou si un seul modèle doit correspondre pour associer un événement à une commande propre au fournisseur. Si aucun modèle n’est associé à une commande propre au fournisseur, ce membre est ignoré. Si MatchAnySinglePattern a la valeur FALSE, tous les modèles doivent correspondre pour associer un événement à la commande. Si MatchAnySinglePattern a la valeur TRUE, la mise en correspondance d’un modèle associe un événement à la commande .

HciHeader

Une structure BTH_COMMAND_HEADER qui contient des informations sur la commande spécifique au fournisseur qui inclut un code d’opération et une longueur de mémoire tampon. La longueur de la mémoire tampon doit inclure uniquement la taille des données à envoyer à la radio. Il ne doit pas inclure la taille des modèles.

Data[1]

Tableau UCHAR qui contient les données et les modèles de la commande spécifiée dans le membre HciHeader . Les modèles sont spécifiés avec des structures BTH_VENDOR_PATTERN .

Remarques

Cette structure BTH_VENDOR_SPECIFIC_COMMAND spécifie la mémoire tampon d’entrée pour le IOCTL_BTH_HCI_VENDOR_COMMAND IOCTL. Cet IOCTL peut être utilisé pour envoyer des commandes spécifiques au fournisseur aux radios Bluetooth.

Pour spécifier la taille des données de commande HCI, utilisez le membre TotalParameterLength dans la structure BTH_COMMAND_HEADER du membre HciHeader de la structure BTH_VENDOR_SPECIFIC_COMMAND.

Des modèles sont requis si une commande propre au fournisseur ne suit pas le contrôle de flux HCI standard et si un événement spécifique au fournisseur est généré en réponse à la commande propre au fournisseur.

Si des modèles sont requis, les modèles suivent les données à envoyer à la radio dans la mémoire tampon du membre de données . Chaque modèle commence par une structure BTH_VENDOR_PATTERN .

Si de tels modèles sont spécifiés, le membre TotalParameterLength ne doit pas inclure la taille des modèles.

Configuration requise

Voir aussi

BTH_COMMAND_HEADER

BTH_VENDOR_PATTERN

IOCTL_BTH_HCI_VENDOR_COMMAND