 |
Distributed Tuning Interface Guide (v11) |
 |
|
DTI を使用する一般的なタスク
ここでは、DTI でよく使用される主要なタスクを説明します。
DTI を使ってサーバーへの接続を行う
サーバーへの接続ハンドルを取得する手順を説明します。多くの DTI 関数にとって、これは最初の手順です。
サーバーへの接続ハンドルを取得するには
- DTI セッションの開始
// 返されるステータス コードを初期化する
BTI_LONG status = 0;
// 予約済みのパラメーターを使って PvStart 関数を
// 呼び出す
status = PvStart(0);
- サーバーへの接続
// 変数を初期化する
BTI_LONG status = 0;
BTI_CHAR_PTR uName = "jsmith";
BTI_CHAR_PTR pword = "123";
BTI_CHAR_PTR svrName = "myserver";
BTI_LONG hConn = 0xFFFFFFFF;
// 実行後、hConn にはほかの関数へ渡すための
// 接続ハンドルが格納される
status = PvConnectServer(svrName, uName, pword, &hConn);
// status が 0 でない場合は、ここでエラー処理を行う
接続ハンドルは多くの DTI 関数で必要となります。同時に複数の接続を開くことができます。ただし、それぞれの接続または関数について、PvDisconnect() 関数を呼び出してハンドルを解放する必要があります。
status = PvDisconnect(phConn);
DTI を使って設定 ID を取得する
設定関数の多くは、パラメーターとして設定 ID を使用します。次の手順は、設定 ID を取得するために必要不可欠な関数について説明します。
特定の設定の ID を取得するには
- 接続ハンドルを取得するために、DTI を使ってサーバーへの接続を行うの手順を実行します。
- 「PvConnectServer()」で返された接続ハンドルを使って 「PvGetCategoryList()」を呼び出し、カテゴリの一覧を取得します。
- 各カテゴリについて、設定の一覧および設定数をそれぞれ 「PvGetSettingList()」と 「PvGetSettingListCount()」を使って取得します。
- 必要な設定を精査します。
- 「PvGetSettingInfo()」を使って、設定についての情報を取得します。
- 完了したら、「PvDisconnect()」を呼び出してサーバーから切断します。
- 「PvStop()」を呼び出して DTI セッションを終了します。
DTI 構造体をパラメーターとして渡す
多くの関数で、関数呼び出しを行うときに DTI 構造体を渡すことが要求されます。以下のサンプル コードでは、構造体を含む関数呼び出しの例を示します。DTI 構造体の詳細については、「DTI 構造体」を参照してください。
WORD rValue = P_OK;
TABLEMAP* tableList;
WORD tableCount;
rValue = PvGetTableNames(m_DictHandle, &tableList, &tableCount);
 DTI のサンプル プログラム |
 Distributed Tuning Interface のリファレンス |
|