BTH_VENDOR_SPECIFIC_COMMAND構造体 (bthioctl.h)
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
データ メンバー内のすべてのパターンが一致するか、1 つのパターンのみが一致してイベントをベンダー固有のコマンドに関連付ける必要があるかどうかを指定する BOOLEAN 値。 ベンダー固有のコマンドに関連付けられているパターンがない場合、このメンバーは無視されます。 MatchAnySinglePattern が FALSE の場合、イベントをコマンドに関連付けるには、すべてのパターンが一致する必要があります。 MatchAnySinglePattern が TRUE の場合、任意のパターンに一致すると、イベントが コマンドに関連付けられます。
HciHeader
操作コードとバッファー長を含むベンダー固有のコマンドに関する情報を含むBTH_COMMAND_HEADER構造体。 バッファー長には、無線に送信されるデータのサイズのみを含める必要があります。 パターンのサイズは含めないようにしてください。
Data[1]
HciHeader メンバーで指定されたコマンドのデータとパターンを含む UCHAR 配列。 パターンは、 BTH_VENDOR_PATTERN 構造体で指定されます。
注釈
このBTH_VENDOR_SPECIFIC_COMMAND構造体は、 の入力バッファーを指定します。 IOCTL_BTH_HCI_VENDOR_COMMAND Ioctl。 この IOCTL を使用して、ベンダー固有のコマンドを Bluetooth 無線に送信できます。
HCI コマンド データのサイズを指定するには、BTH_VENDOR_SPECIFIC_COMMAND構造体の HciHeader メンバーのBTH_COMMAND_HEADER構造体で TotalParameterLength メンバーを使用します。
ベンダー固有のコマンドが標準の HCI フロー制御に従わない場合、ベンダー固有のコマンドに応答してベンダー固有のイベントが生成される場合は、パターンが必要です。
パターンが必要な場合、パターンはデータ メンバー バッファー内の無線に送信される データ に従います。 各パターンは 、BTH_VENDOR_PATTERN 構造体で始まります。
このようなパターンが指定されている場合、 TotalParameterLength メンバーにはパターンのサイズを含めないようにしてください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista のバージョン:_Available、およびそれ以降のバージョンの Windows。 |
| Header | bthioctl.h (Bthioctl.h を含む) |