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