<?xml version="1.0" encoding="Shift_JIS"?>
<?xml-stylesheet type="text/xsl" href="../Fmethod_xsl/fmethod_he_c.xsl"?>

<root>
    <func>


        <!-- 関数名 -->
        <title>cnc_rdparam_ext</title>



        <!-- 関数宣言 -->
        <declare>
        <!-- Visual C++の宣言 -->
            <vc>
                <include>#include "fwlib32.h"</include>
                <prottype>FWLIBAPI short WINAPI cnc_rdparam_ext(unsigned short FlibHndl, long *prm_no, short num, IODBPRM *param);</prottype>
            </vc>
        </declare>



        <!-- 解説 -->
        <doc>
            <cmn>
                <p>
                    非連続な番号のパラメータをリードします。
                    リードするパラメータ番号は、longの配列( prm_no[] )にて指定します。その配列の個数は引数numにて指定します。
                </p>
                <p>
                    リードしたパラメータに関する情報は、IODBPRM構造体の配列に格納されます。
                    存在しないパラメータ番号が指定された場合は、IODBPRM構造体のtypeに-1が格納されます。
                    軸型でないパラメータの値は、IODBPRM構造体のdata[0]に格納されます。
                    軸型の場合は、IODBPRM構造体のdata配列に格納されます。
                </p>
                <p>パラメータの値は全てlongで格納されていますので、型情報に応じてアプリケーションでキャストを行う必要があります。</p>
                <p>各パラメータの詳細については CNCのパラメータ説明書を参照して下さい。</p>
                <p class="info">なお、スピンドル関係パラメータは軸型として扱われます。有効データはスピンドルの個数分となります。</p>
            </cmn>
        </doc>



        <!-- 引数 -->
        <argument>
            <common>
                <vc>
                    <item>
                        <name>FlibHndl</name>
                        <type>in</type>
                        <content>
                            <p>
                                ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                            </p>
                        </content>
                    </item>
                    <item>
                        <name>prm_no</name>
                        <type>in</type>
                        <content>
                            <p>リードするパラメータ番号を指定した配列へのポインタです。</p>
                            <p>
                                指定可能なパラメータ番号は CNCのパラメータ説明書を参照してください。
                                また、<a href="ncdata/cnc_rdparanum.htm" target="_parent">cnc_rdparanum</a>関数、
                                及び<a href="ncdata/cnc_rdparainfo.htm" target="_parent">cnc_rdparainfo</a>関数でも取得できます。
                            </p>
                        </content>
                    </item>
                    <item>
                        <name>num</name>
                        <type>in</type>
                        <content>
                            <p>リードするパラメータの個数を指定します。</p>
                        </content>
                    </item>
                    <item>
                        <name>param</name>
                        <type>out</type>
                        <content>
                            <p>
                                リードしたパラメータを格納する IODBPRM構造体の配列へのポインタです。
                                この配列はnumで指定した数分必要です。IODBPRM構造体は次の通りです。
                            </p>
<pre>
typedef struct iodbprm {
    long datano;        /* パラメータ番号 */
    short type;         /* 型情報 */
    short axis;         /* 軸情報 */
    short info;         /* 属性 */
    short unit;         /* 単位 */
    struct {
        long prm_val;   /* パラメータの値 */
        long dec_val;   /* 小数点以下桁数 */
    } data[32];
} IODBPRM;
</pre>
                            <dl>
                                <dt>datano</dt>
                                <dd>パラメータ番号が格納されます。</dd>
                                <dt>type</dt>
                                <dd>リードしたパラメータの型情報が格納されます。</dd>
                                <dd>
                                    <table class="dd">
                                        <tr>
                                            <td>0</td>
                                            <td>:</td>
                                            <td>ビット型</td>
                                        </tr>
                                        <tr>
                                            <td>1</td>
                                            <td>:</td>
                                            <td>バイト型</td>
                                        </tr>
                                        <tr>
                                            <td>2</td>
                                            <td>:</td>
                                            <td>ワード型</td>
                                        </tr>
                                        <tr>
                                            <td>3</td>
                                            <td>:</td>
                                            <td>2ワード型</td>
                                        </tr>
                                        <tr>
                                            <td>4</td>
                                            <td>:</td>
                                            <td>実数型 <span class = "xis">( Series 150i, 300i )</span></td>
                                        </tr>
                                        <tr>
                                            <td>-1</td>
                                            <td>:</td>
                                            <td>存在しないパラメータ番号</td>
                                        </tr>
                                    </table>
                                </dd>
                                <dt>axis</dt>
                                <dd>リードしたパラメータの軸情報が格納されます。
                                    <table class="dd">
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <tr>
                                            <td>bit 0</td>
                                            <td>:</td>
                                            <td>軸属性
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>軸なし</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>軸あり</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 1</td>
                                            <td>:</td>
                                            <td>スピンドルパラメータ
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>スピンドル以外</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>スピンドル</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 2〜15</td>
                                            <td>:</td>
                                            <td>(リザーブ)</td>
                                        </tr>
                                    </table>
                                </dd>
                                <dt>info</dt>
                                <dd>リードしたパラメータの属性が格納されます。
                                    <table class="dd">
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <tr>
                                            <td>bit 0</td>
                                            <td>:</td>
                                            <td>符号
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>符号あり</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>符号なし</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 1</td>
                                            <td>:</td>
                                            <td>セッティング入力可
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>不可</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>可</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 2</td>
                                            <td>:</td>
                                            <td>書き込み禁止
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>可</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>不可</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 3</td>
                                            <td>:</td>
                                            <td>書き込み後電源断／再投入が必要
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>不要</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>必要</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 4</td>
                                            <td>:</td>
                                            <td>リード不可
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>可</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>不可</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 5〜15</td>
                                            <td>:</td>
                                            <td>(リザーブ)</td>
                                        </tr>
                                    </table>
                                </dd>
                                <dt>unit</dt>
                                    <dd>リードした実数型パラメータの単位が格納されます。
                                    <table class="dd">
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <tr>
                                            <td>bit 0, 1</td>
                                            <td>:</td>
                                            <td>属性
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>実数型以外</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>実数型入力単位</td>
                                                    </tr>
                                                    <tr>
                                                        <td>2</td>
                                                        <td>:</td>
                                                        <td>実数型出力単位</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 2〜4</td>
                                            <td>:</td>
                                            <td>単位
                                                <table class="dd">
                                                    <tr>
                                                        <td>0</td>
                                                        <td>:</td>
                                                        <td>無単位</td>
                                                    </tr>
                                                    <tr>
                                                        <td>1</td>
                                                        <td>:</td>
                                                        <td>長さの単位</td>
                                                    </tr>
                                                    <tr>
                                                        <td>2</td>
                                                        <td>:</td>
                                                        <td>角度の単位</td>
                                                    </tr>
                                                    <tr>
                                                        <td>3</td>
                                                        <td>:</td>
                                                        <td>長さ+角度の単位</td>
                                                    </tr>
                                                    <tr>
                                                        <td>4</td>
                                                        <td>:</td>
                                                        <td>速度の単位</td>
                                                    </tr>
                                                </table>
                                            </td>
                                        </tr>
                                        <tr>
                                            <td>bit 5〜15</td>
                                            <td>:</td>
                                            <td>(リザーブ)</td>
                                        </tr>
                                    </table>
                                </dd>
                                <dt>data</dt>
                                <dd>パラメータの値が格納されます。
                                    <table class="dd">
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <colgroup valign="top"/>
                                        <tr>
                                            <td>prm_val</td>
                                            <td>:</td>
                                            <td>パラメータの値</td>
                                        </tr>
                                        <tr>
                                            <td>dec_val</td>
                                            <td>:</td>
                                            <td>小数点以下桁数(実数型のみ有効)</td>
                                        </tr>
                                    </table>
                                </dd>
                            </dl>
                        </content>
                    </item>
                </vc>
            </common>
        </argument>



        <!-- 戻り値 -->
        <errcode>
            <item>
                <name>EW_LENGTH</name>
                <content>
                    データブロック長の誤り<br/>パラメータの個数numが0以下です。
                </content>
            </item>
            <item class="xis">
                <name>EW_PASSWD</name>
                <content>指定されたパラメータは保護されているため読み込めません。<br/>( Series 160i/180i/210i, 0i )</content>
            </item>
        </errcode>



        <!-- CNCオプション -->
        <option>
            <hssb>拡張ドライバ/ライブラリ機能が必要です。</hssb>
            <ethr><p>イーサネット機能と拡張ドライバ/ライブラリ機能が必要です。</p>
                  <p>但し、Series 160i/180i/210i/0i MODEL B, 300i に関しては次のようになります。</p>
                  <p>組込みイーサネットを使用のとき、</p>
                  <p><ul>上記２つの機能は必要ありません。</ul></p>
                  <p>イーサネットボードを使用のとき、</p>
                  <p><ul>イーサネット機能のみ必要です。</ul></p>
            </ethr>
        </option>



        <!-- CNCパラメータ -->
        <parameter></parameter>



        <!-- CNCモード -->
        <mode></mode>



        <!-- 対応機種 -->
        <support>
            <!-- M（ミリング） -->
            <m>
                  <fs0ia>X</fs0ia>
                <fs0ib>E</fs0ib>
                <fs15>X</fs15>
                <fs15i>E</fs15i>
                <fs16>X</fs16>
                <fs18>X</fs18>
                <fs21>X</fs21>
                <fs16ia>E</fs16ia>
                <fs18ia>E</fs18ia>
                <fs21ia>E</fs21ia>
                <fs16ib>E</fs16ib>
                <fs18ib>E</fs18ib>
                <fs21ib>E</fs21ib>
                <fs30i>O</fs30i>
            </m>
            <!-- T（旋盤） -->
            <t>
                  <fs0ia>X</fs0ia>
                <fs0ib>E</fs0ib>
                <fs15>X</fs15>
                <fs15i>X</fs15i>
                <fs16>X</fs16>
                <fs18>X</fs18>
                <fs21>X</fs21>
                <fs16ia>E</fs16ia>
                <fs18ia>E</fs18ia>
                <fs21ia>E</fs21ia>
                <fs16ib>E</fs16ib>
                <fs18ib>E</fs18ib>
                <fs21ib>E</fs21ib>
                <fs30i>O</fs30i>
            </t>
            <!-- LC（ローダ制御） -->
            <lc>
                  <fs0ia>X</fs0ia>
                <fs0ib>X</fs0ib>
                <fs15>X</fs15>
                <fs15i>X</fs15i>
                <fs16>X</fs16>
                <fs18>X</fs18>
                <fs21>X</fs21>
                <fs16ia>X</fs16ia>
                <fs18ia>X</fs18ia>
                <fs21ia>X</fs21ia>
                <fs16ib>X</fs16ib>
                <fs18ib>X</fs18ib>
                <fs21ib>X</fs21ib>
                <fs30i>X</fs30i>
            </lc>
            <!-- P（パンチプレス） -->
            <p>
                <fs16i>E</fs16i>
                <fs18i>E</fs18i>
            </p>
            <!-- L（レーザ） -->
            <l>
                <fs16i>E</fs16i>
                <fs18i>X</fs18i>
            </l>
            <!-- W（ワイヤカット） -->
            <w>
                <fs16i>E</fs16i>
                <fs18i>E</fs18i>
            </w>
            <!-- PM（パワーメート） -->
            <pw>
                <d>E</d>
                <h>E</h>
            </pw>
            <!-- 300is -->
            <is>
                <m>
                    <fs30is>O</fs30is>
                </m>
                <t>
                    <fs30is>O</fs30is>
                </t>
            </is>
        </support>



        <!-- 参照 -->
        <reference>
            <item>
                <name>cnc_rdparam</name>
                <file>ncdata/cnc_rdparam.htm</file>
            </item>
            <item>
                <name>cnc_wrparam</name>
                <file>ncdata/cnc_wrparam.htm</file>
            </item>
            <item>
                <name>cnc_rdparar</name>
                <file>ncdata/cnc_rdparar.htm</file>
            </item>
            <item>
                <name>cnc_wrparas</name>
                <file>ncdata/cnc_wrparas.htm</file>
            </item>
            <item>
                <name>cnc_rdparainfo</name>
                <file>ncdata/cnc_rdparainfo.htm</file>
            </item>
            <item>
                <name>cnc_rdparanum</name>
                <file>ncdata/cnc_rdparanum.htm</file>
            </item>
        </reference>



        <!-- プログラム例 -->
        <example>
<vc>
以下のプログラムはパラメータNo.20とNo.1020を読みだし画面に表示します。

#include "fwlib32.h"

void example()
{
        IODBPRM prm[2];
        long prmno[2];

        prmno[0] = 20;
        prmno[1] = 1020;
        ret = cnc_rdparam_ext( h, prmno, 2, prm ) ;
        if ( !ret ) {
                printf( "No.20: = %d\n", prm[0].data[0].prm_val );

                printf( "No.1020:\n" );
                printf( "  1st axis = %d\n", prm[1].data[0].prm_val );
                printf( "  2nd axis = %d\n", prm[1].data[1].prm_val );
                printf( "  3rd axis = %d\n", prm[1].data[2].prm_val );
        }
}
</vc>
        </example>



    </func>
</root>
