その後のすべてのNI-SWITCH呼び出しにおいて、スイッチモジュール識別に使用されるセッションハンドルを返し、オプションでセッションの初期状態を設定します。

このVIは、リソース名で指定されたスイッチモジュールの新規IVI計測器ドライバセッションを作成します。そのデバイスで使用可能な トポロジが複数ある場合、NI-SWITCHはMAXで指定されたデフォルトトポロジを使用します。トポロジはオプション文字列でも構成可能です。

デフォルトで、スイッチモジュールは既知の状態にリセットされます。

オプション文字列で シミュレーションを有効にします。

指定したリソースへのセッションが別のプロセスに存在する場合、エラーが返されます。同じトポロジ、同じリソース、同じプロセスでこのVIを2度呼び出すと同じセッションが返されます。

関連トピック


icon

入力/出力

  • cstr.png オプション文字列 (Simulate=0,RangeCheck=1,DriverSetup=topology:1127/2-Wire 32x1 Mux) —

    オプション文字列は、NI-SWITCHセッションにおける特定プロパティの初期値を設定します。

    以下の表は、使用可能なプロパティ文字列名を記載しています。

    プロパティ文字列名 デフォルト値
    RangeCheck 1
    QueryInstrStatus 1
    キャッシュ 1
    シミュレーション 0
    RecordCoercions 0
    DriverSetup topology:1127/2-Wire 32x1 Mux

    オプション文字列の形式は「PropertyStringName=Value」です。PropertyStringNameは上記の属性名で、Valueはプロパティに設定する値です。複数のプロパティを設定する場合、カンマで区切ります。

    空の文字列オプション文字列を渡すと、NI-SWITCHセッションはプロパティのデフォルト値を使用します。値を割り当てることでデフォルト値を上書きすることができます。すべての使用可能なプロパティを指定する必要はありません。属性を指定しない場合、そのデフォルト値が使用されます。

    スイッチモジュールのトポロジまたはリソースタイプを設定するには、 ドライバセットアッププロパティを使用します。この属性には、構成トークン/値のペアが含まれます。

    DriverSetup=[構成トークン]:[値];[構成トークン2]:[値2]

    以下の表は有効な構成トークンおよび値を記載しています。

    トークン 値
    トポロジ 有効な値については デバイスを参照してください。デフォルト: 各デバイスに対してMAXで構成されたトポロジです。
    resourcetype MAXのNI-DAQmxデバイスの下で構成されているデバイスの場合はdaqmxになります。デフォルト: daqmx

    たとえば、MAXのDAQmxデバイスの下で構成されているNI SCXI-1127を、以下の文字列を使用して2線式32x1マルチプレクサとして設定します。

    DriverSetup=topology:1127/2-Wire 32x1 Mux;resourcetype:daqmx

    ドライバセットアップ文字列は、IviSwitchクラスドライバを介してNI-SWITCHを使用する場合に特に重要です。

    シミュレーションを有効にするには、 Simulateプロパティを1に設定し、シミュレートするスイッチモジュールとトポロジを指定します。以下の文字列は2線式32×1マルチプレクサとして構成されたNI SCXI-1127のシミュレーションを有効にします。

    Simulate=1, DriverSetup=topology:1127/2-Wire 32x1 Mux

    Simulateプロパティが1に設定され、 ドライバセットアッププロパティでトポロジが指定されている場合、トポロジに基づいてシミュレートするスイッチモジュールが決まります。 ドライバセットアッププロパティでトポロジが指定されていない場合、リソース名で指定されたスイッチがシミュレートされます。

  • civrn.png リソース名 —

    リソース名には、Measurement & Automation Explorer (MAX) によって割り当てられた計測器の リソース名（例：PXI1Slot3）を指定します。IVI論理名は、リソース名としても有効です。

  • cbool.png IDクエリ (TRUE) —

    IDクエリは無視されます。

    NI-SWITCHは複数のスイッチモジュールをサポートするため、必ずスイッチモジュールをクエリして取り付けられているモジュールを特定します。この理由により、このパラメータがFALSEに設定されている場合、このVIは「クエリに失敗しました」というエラーを返します。

  • cbool.png デバイスをリセット (TRUE) —

    デバイスをリセットは、初期化中にスイッチモジュールをリセットするかどうかを指定します。デフォルトはTRUE (1)です。

    メモ コンピュータを再起動した後で「niSwitch初期化 (トポロジ指定)」VIを最初に呼び出した際に、ハードウェアがリセットされます。これはリセットフラグが適用されない唯一のケースです。
    TRUE (1)

    デバイスをリセットします。
    FALSE (0)

    デバイスをリセットしません。
  • cerrcodeclst.png エラー入力 (エラーなし) —

    エラー入力は、このノードの実行前に発生したエラー状態を示します。この入力は標準のエラー入力機能を提供します。

  • iivrn.png 計測器ハンドル出力 —

    計測器ハンドル出力は、「niSwitch初期化 (トポロジ指定)」、「niSwitch初期化 (オプション付)」、または「niSwitch初期化」VIで確立された特定のNI-SWITCHセッションを識別し、その後に続くすべてのNI-SWITCH呼び出しで使用されます。

  • ierrcodeclst.png エラー出力 —

    エラー出力にはエラー情報が含まれます。この出力は標準のエラー出力機能を提供します。