structure BTH_VENDOR_SPECIFIC_COMMAND (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 spécifique 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 spécifique au fournisseur.
MatchAnySinglePattern
Valeur BOOLEAN qui spécifie si tous les modèles du membre Data doivent correspondre ou un seul modèle doit correspondre pour associer un événement à une commande spécifique au fournisseur. S’il n’existe aucun modèle associé à une commande spécifique au fournisseur, ce membre est ignoré. Si MatchAnySinglePattern est FALSE, tous les modèles doivent correspondre pour associer un événement à la commande. Si MatchAnySinglePattern est TRUE, la mise en correspondance d’un modèle associe un événement à la commande.
HciHeader
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 ne doit inclure que 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 la IOCTL_BTH_HCI_VENDOR_COMMAND IOCTL. Ce 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 BTH_VENDOR_SPECIFIC_COMMAND de la structure HciHeader.
Les modèles sont requis si une commande spécifique au fournisseur ne suit pas le contrôle de flux HCI standard et qu’un événement spécifique au fournisseur est généré en réponse à la commande spécifique au fournisseur.
Si des modèles sont requis, les modèles suivent les données à envoyer à la radio dans la mémoire tampon membre Data. 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Available dans Windows Vista et versions ultérieures de Windows. |
| d’en-tête | bthioctl.h (include Bthioctl.h) |