CASSIOPEIA DT-10 ライブラリマニュアル for VB 【Bluetooth 編】 Ver 1.00 Copyright© 2005 CASIO COMPUTER CO., LTD. All rights reserved.
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB 変 更 履 歴 No Revision 更新日 項 １ 1.00 05/2/23 初版 改訂内容 初版発行 2 ３ ４ ５ ６ ７ ８ ９ １０ １１ １２ １３ １４ １５ １６ １７ １８ １９ ２０ ２１ ２２ ２３ ２４ ２５ Copyright© 2005 CASIO COMPUTER CO., LTD. All rights reserved.
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB 目次 1. 概要.........................................................................................................................................................1 2. 動作環境..................................................................................................................................................1 3. 開発環境..........................................................................................................................................
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB 1. 概要 このライブラリはモバイル抽象化 API の Bluetooth.NET クラスライブラリです。VisualStudio .NET2003 VB 開発環境で利用するためのクラスライブラリ仕様について述べたものです。 2. 動作環境 ■機種 DT-10 ■OS Windows Mobile 2003 Second Edition Software for PocketPC 3. 開発環境 ■Microsoft Visual Studio 2003 ＋ Windows CE Utilities for Visual Studio .NET 2003 アドオン パック 4. 提供ファイル クラスライブラリとして、以下のライブラリを提供します。 ライブラリ名 クラスライブラリ Bluetooth VB 用クラスライブラリ BluetoothLibNet.dll Bluetooth ライブラリ BluetoothLib.dll Bluetooth ライブラリ BTLib.
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB 5. Bluetooth VB 用ライブラリ 5-1.使用方法 ・開発環境において、参照設定に「BluetoothLibNet.dll」を追加し、関数は、Calib.BluetoothLibNet.Api.関数 名として呼び出し、定義値は、Calib.BluetoothLibNet.Def.定義値と呼び出しアプリケーションを作成します。ま た、「BluetoothLibNet.dll」は実行時にも作成したアプリケーションと同一のフォルダ内に入れます。 事前に、「BluetoothLib.dll」、 「BTLib.dll」を DT-10 の Windows フォルダにコピーしてください。 5-2.
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTST_LOCALINFO 構造体 DT-10 本体の Bluetooth デバイス情報を格納する構造体です。 Public Class BTST_LOCALINFO String LocalName Bluetooth 機器名 String LocalAddress Bluetooth 機器アドレス Integer LocalDeviceMode Bluetooth デバイスモード Integer LocalClass1 Bluetooth デバイスクラス 1(ローカル) Integer LocalClass2 Bluetooth デバイスクラス 2(ローカル) Integer LocalClass3 Bluetooth デバイスクラス 3(ローカル) Boolean Authentication Bluetooth 認証設定フラグ Boolean Encryption 暗号設定フラグ End Class BTST_LOCALINFO 構造体を使用する関数は以下の通
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTGetServiceInfo BTSelectDevice BTTrustDevice BTRegisterDeviceInfo BTSearchDeviceInfo BTDeleteDeviceInfo BTGetDefaultDeviceInfo BTSetDefaultDevice BTCreateBond 5-4.
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTInitialize 機能 DT-10 本体の Bluetooth デバイスの使用を開始します。Bluetooth 仮想 COM ポートも初期化されます。 他の Bluetooth 機器との接続および通信を行う前に、最初にこの関数を必ず実行してください。 書式 BTInitialize ( ) As Int32 ﾊﾟﾗﾒｰﾀ なし 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED 初期化に失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー 5
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTDeInitialize DT-10 本体の Bluetooth デバイスの使用を終了します。Bluetooth 仮想 COM ポートも使用できなくな 機能 ります。 他の Bluetooth 機器との通信終了後、最後にこの関数を必ず実行してください。 書式 BTDeInitialize ( ) As Int32 ﾊﾟﾗﾒｰﾀ なし 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED リソース解放に失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー 備考 本関数を実行しないでユーザアプリケーションを終了した場合、次回 BTInitialize 関数を実行したときに エラーが発生して、DT-10 本体の Bluetooth デバイスが使用できなくなる可能性があります。 6
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTGetLocalInfo 機能 DT-10 本体の Bluetooth デバイス情報を取得します。本関数では、BTST_LOCALINFO 構造体の全て のメンバが取得されます。 Bluetooth デバイスモードおよび Bluetooth デバイスクラスにおいて取得可能なパラメータについては、 Bluetooth ライブラリマニュアル（C++編）7-2 を参照してください。 書式 BTGetLocalInfo (ByVal LocalInfo As BTST_LOCALINFO) As Int32 ﾊﾟﾗﾒｰﾀ LocalInfo 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED デバイス情報取得失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー [out] DT-10 本体の Bluetooth デバイス情報 7
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTSetLocalInfo 機能 DT-10 本体の Bluetooth デバイス情報を設定します。本関数を実行する前に、BTGetLocalInfo 関数を 実行して、現在の Bluetooth デバイス情報を取得してください。 本関数では、BTST_LOCALINFO 構造体のメンバのうち、Bluetooth アドレスを除く全てのデバイス情 報が設定されます。Bluetooth デバイスモードおよび Bluetooth デバイスクラスにおいて設定可能なパ ラメータについては、Bluetooth ライブラリマニュアル（C++編）7-２を参照してください。 書式 BTSetLocalInfo (ByVal LocalInfo As BTST_LOCALINFO) As Int32 ﾊﾟﾗﾒｰﾀ LocalInfo 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED デバイス情報設定失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTInquiry 機能 Bluetooth 機器の Inquiry（問い合わせ）を実行します。 書式 BTInquiry (ByVal DeviceHandle() As IntPtr, ByRef DeviceNumber As Int32, _ ByVal InquiryTime As Integer) As Int32 ﾊﾟﾗﾒｰﾀ 戻り値 備考 DeviceHandle [in] IntPtr[]の配列を用意する（ダミー） DeviceNumber [out]Inquiry で発見された Bluetooth 機器の数を格納する変数 InquiryTime 常に 0 を設定してください BTERR_SUCCESS 正常終了 BTERR_FAILED Bluetooth 機器の Inquiry 失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー DeviceNumber で小さい値を指定すると、Inquiry に
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTGetDeviceInfo 機能 BTInquiry 関数で発見された Bluetooth 機器のデバイス情報を取得します。BTInquiry 関数を実行後、 必ず本関数を実行して Bluetooth 機器情報を取得してください。 本関数で取得できるデバイス情報は、以下の通りです。Bluetooth デバイスクラスにおいて取得可能な パラメータについては、Bluetooth ライブラリマニュアル（C++編）7-2 を参照してください。 ・Bluetooth 機器名 ・Bluetooth 機器アドレス ・Bluetooth デバイスクラス 書式 BTGetDeviceInfo (ByVal DeviceInfo() As BTST_DEVICEINFO, _ ByVal DeviceNumber As Integer, ByVal DeviceHandle As IntPtr) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo [out]Bluetooth 機器情報を格納する構造体変数 BTI
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTGetServiceInfo 機能 通信する Bluetooth 機器のサービス情報を取得します。取得可能なサービスクラスパラメータについて は、抽象化ライブラリ 4-7-2 を参照してください。 本関数を実行する前に、BTGetDeviceInfo 関数を実行して、サービス情報以外のデバイス情報をあらか じめ取得してください。 書式 BTGetServiceInfo (ByVal DeviceInfo As BTST_DEVICEINFO) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED Bluetooth 機器サービス情報取得失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー 備考 [in / out] Bluetooth 機器情報 本関数を実行しなくても、Bluetooth 機器との接続を行うことは可能です。サポートしている通信プロ ファイ
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTSelectDevice 接続する Bluetooth 機器を指定します。Bluetooth 通信を開始する前にこの関数を実行して、接続する 機能 Bluetooth 機器を選択してください。 BTSelectDevice (ByVal DeviceInfo As BTST_DEVICEINFO, _ 書式 ByVal PortName As String) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo [in]接続する Bluetooth 機器の情報 デフォルトの Bluetooth 機器を指定する場合、NULL を指定する PortName [in] 接続する通信ポート 以下の中から一つを指定する 戻り値 備考 BTPORT_SERIAL 仮想シリアル BTPORT_DIALUP ダイヤルアップ BTERR_SUCCESS 正常終了 BTERR_FAILED Bluetooth 機器の指定に失敗 BTERR_DRIVER ドライバーエラー FUNCTION
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTSetPassKey 機能 DT-10 本体の PassKey を設定します。PassKey は、DT-10 本体で他の Bluetooth 機器とのボンドを実 行する場合、および他の Bluetooth 機器から PassKey 要求があったときに使用されます。 パラメータの設定により、他の Bluetooth 機器からの PassKey 要求を拒否することが可能です。設定し た PassKey は、BTSetPassKey 関数および BTDeInitialize 関数を実行するまで有効です。 書式 BTSetPassKey (ByVal PassKey As String) As Int32 ﾊﾟﾗﾒｰﾀ PassKey [in] 設定するパスキー NULL または空文字列(””)を指定した場合、他の Bluetooth 機器からの PassKey 要求 を拒否する 戻り値 備考 BTERR_SUCCESS 正常終了 BTERR_FAILED PassKey の設定に失敗 B
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTTrustDevice 機能 DT-10 本体から、指定した Bluetooth 機器との信頼を行います。 書式 BTTrustDevice (ByVal DeviceInfo As BTST_DEVICEINFO, _ ByVal PortName As String) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo [in]デバイスの信頼を実行する Bluetooth 機器の情報 NULL を指定した場合、デフォルトの Bluetooth 機器とのデバイスの信頼を実行す る PortName [in]デフォルトで通信する設定をした通信ポート DeviceInfo で NULL を指定した場合のみ、以下の中から一つを指定する 戻り値 備考 BTPORT_SERIAL 仮想シリアル BTPORT_DIALUP ダイヤルアップ BTERR_SUCCESS 正常終了 BTERR_FAILED Bluetooth 機器とのボンドに失敗 BTERR_DRIVER ドライバ
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTGetLastError 機能 Bluetooth ライブラリ関数呼び出しで発生したエラー詳細を取得します。 書式 BTGetLastError( ) As Int32 ﾊﾟﾗﾒｰﾀ なし 戻り値 エラーコード詳細が、戻ります。 FUNCTION_UNSUPPORT 未サポートエラー 15
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTRegisterLocalInfo 機能 DT-10 本体の Bluetooth デバイス情報をレジストリに登録します。 登録したデバイス情報は、次回 BTInitialize 関数を実行したときに再設定されます。 書式 BTRegisterLocalInfo ( ) As Int32 ﾊﾟﾗﾒｰﾀ なし 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED デバイス情報登録失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー 備考 Bluetooth デバイス情報を変更してレジストリに登録する場合は、 本関数を実行する前に BTSetLocalInfo 関数を実行して、Bluetooth デバイス情報を変更してください。 16
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTRegisterDeviceInfo 機能 Bluetooth 機器の情報をレジストリに登録します。 書式 BTRegisterDeviceInfo (ByVal DeviceInfo As BTST_DEVICEINFO) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED Bluetooth 機器情報のレジストリへの登録失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー 備考 [in] 登録する Bluetooth 機器の情報 登録する Bluetooth 機器情報の Bluetooth アドレスがすでにレジストリに登録されている場合、以前登 録した Bluetooth 機器情報は上書きされます。 17
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTSearchDeviceInfo 機能 検索キーを指定して、Bluetooth 機器の情報をレジストリから検索して取得します。 検索キーと一致する Bluetooth 機器情報の数のみを取得することも可能です。 書式 BTSearchDeviceInfo (ByVal DeviceInfo() As BTST_DEVICEINFO, _ ByRef DeviceNumber As Integer, ByVal SearchKey As String) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo [in / out] キーと一致した Bluetooth 機器の情報 DeviceNumber で指定した数以上の配列を用意する NULL を指定した場合、キーと一致した Bluetooth 機器の数のみを返す DeviceNumber [in / out] 取得する Bluetooth 機器情報の最大値を設定する 実行後、キーと一致した Bluetooth 機器の数が格納される Searc
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTDeleteDeviceInfo 機能 指定した Bluetooth 機器の情報をレジストリから削除します。 書式 BTDeleteDeviceInfo (ByVal DeviceInfo As BTST_DEVICEINFO) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo 戻り値 BTERR_SUCCESS 正常終了 BTERR_FAILED Bluetooth 機器情報のレジストリからの削除失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー 備考 [in] 削除する Bluetooth 機器の情報を格納する構造体 指定する Bluetooth 機器情報は、BTSearchDeviceInfo 関数を使用して取得してください。 引数として使用する Bluetooth 機器情報が、レジストリに登録されている Bluetooth 機器情報と一致し ない場合、エラーとなります。 19
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTGetDefaultDeviceInfo 機能 デフォルトで通信する Bluetooth 機器の情報を取得します。 書式 BTGetDefaultDeviceInfo (ByVal DeviceInfo As BTST_DEVICEINFO, _ ByVal PortName As String) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo [out] PortName [in] デフォルトの Bluetooth 機器の情報を取得する構造体 デフォルトの Bluetooth 機器と通信するときの通信ポート 以下の中から一つを指定する 戻り値 備考 BTPORT_SERIAL 仮想シリアル BTPORT_DIALUP ダイヤルアップ BTERR_SUCCESS 正常終了 BTERR_FAILED デフォルトで通信する Bluetooth 機器情報の取得失敗 BTERR_DRIVER ドライバーエラー FUNCTION_UNSUPPORT 未サポートエラー
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB BTSetDefaultDevice 機能 デフォルトで通信する Bluetooth 機器を設定します。 本関数で設定したデフォルトの Bluetooth 機器は、次回 BTInitialize 関数を実行したときに有効となり ます。 書式 BTSetDefaultDevice (ByVal DeviceInfo As BTST_DEVICEINFO, _ ByVal PortName As String) As Int32 ﾊﾟﾗﾒｰﾀ DeviceInfo [in] デフォルトに設定する Bluetooth 機器の情報を格納する構造体 NULL を指定した場合、デフォルトで通信するデバイスを設定しない PortName [in] デフォルトの Bluetooth 機器と通信するときの通信ポート 以下の中から一つを指定する 戻り値 備考 BTPORT_SERIAL 仮想シリアル BTPORT_DIALUP ダイヤルアップ BTERR_SUCCESS 正常終了 BTERR_FA
DT-10 ライブラリマニュアル CASIO Bluetooth Library for VB DT-10 ライブラリマニュアル for VB 【Bluetooth 編】 Ver1.
