BTH_VENDOR_SPECIFIC_COMMAND構造体は、ベンダー固有のコマンドBluetooth指定します。
構文
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;
メンバーズ
ManufacturerId
ラジオの製造元識別子。 この製造元識別子を持つ無線は、ベンダー固有のコマンドを受け取ることができます。
LmpVersion
リンク管理プロトコル (LMP) バージョンを含む UCHAR。 無線の LMP バージョンがこの値より大きい場合、コマンドは無線に送信されます。 それ以外の場合、無線はコマンドを受信しません。 LmpVersion が 0 の場合、すべての無線はベンダー固有のコマンドを受け取ります。
MatchAnySinglePattern
イベントをベンダー固有のコマンドに関連付けるために、Data メンバー内のすべてのパターンが一致するか、1 つのパターンのみが一致する必要があるかどうかを指定する BOOLEAN 値。 ベンダー固有のコマンドに関連付けられているパターンがない場合、このメンバーは無視されます。 MatchAnySinglePattern が FALSE 場合、すべてのパターンが一致してイベントをコマンドに関連付ける必要があります。 MatchAnySinglePattern TRUE 場合、パターンに一致すると、イベントがコマンドに関連付けられます。
HciHeader
操作コードとバッファー長を含むベンダー固有のコマンドに関する情報を含む BTH_COMMAND_HEADER 構造体。 バッファー長には、無線に送信されるデータのサイズのみを含める必要があります。 パターンのサイズを含めてはなりません。
Data[1]
HciHeader メンバーで指定されたコマンドのデータとパターンを含む UCHAR 配列。 パターンは、BTH_VENDOR_PATTERN 構造体で指定されます。
備考
このBTH_VENDOR_SPECIFIC_COMMAND構造体は、次の値の入力バッファーを指定します。IOCTL を IOCTL_BTH_HCI_VENDOR_COMMAND します。 この IOCTL を使用して、ベンダー固有のコマンドを送信して無線をBluetoothできます。
HCI コマンド データのサイズを指定するには、BTH_VENDOR_SPECIFIC_COMMAND構造体の HciHeader メンバーの BTH_COMMAND_HEADER 構造体で、TotalParameterLength メンバーを使用します。
ベンダー固有のコマンドが標準の HCI フロー制御に従っていない場合に、ベンダー固有のコマンドに応答してベンダー固有のイベントが生成される場合は、パターンが必要です。
パターンが必要な場合、パターンは、Data メンバー バッファー内の無線に送信されるデータに従います。 各パターンは、BTH_VENDOR_PATTERN 構造体で始まります。
このようなパターンが指定されている場合、TotalParameterLength メンバーにパターンのサイズを含めないようにする必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista のバージョン:_Available、およびそれ以降のバージョンの Windows。 |
| ヘッダー | bthioctl.h (Bthioctl.h を含む) |