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

<root>
  <func>


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



    <!-- 関数宣言 -->
    <declare>
      <!-- Visual C++の宣言 -->
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_dtsvwrfile(unsigned short FlibHndl,char *pc_file,char *dtsv_file,short chnl);</prottype>
      </vc>
    </declare>



    <!-- 解説 -->
    <doc>
        <cmn>
            パーソナルコンピュータのハードディスク上のファイルをデータサーバへ書き込みます。<br/>
            この関数は、データサーバボード(10BASE-T)でのみ使用可能です。<br/>
            本関数は、Series 160i/180i/210i, 0i で有効です。
        </cmn>
    </doc>



    <!-- 引数 -->
    <argument>
        <hssb>
            <cmn>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        ライブラリハンドルです。詳細は、「<a href="handle.htm" target="_parent">ライブラリハンドル</a>」を参照して下さい。
                    </content>
                </item>
                <item>
                    <name>pc_file</name>
                    <type>in</type>
                    <content>
                        パーソナルコンピュータ側のファイル名へのポインタ<br/>
                        パーソナルコンピュータ側のファイル名指定について以下に示します。<br/>
                        <ul>
                            <li>ASCII文字列を使用して下さい。</li>
                            <li>ファイル名の最後はNULLで終了してください。</li>
                            <li>フルパスで、指定してください。</li>
                            <li>ワイルドカード('*','?')は使用できません。</li>
                        </ul>
                    </content>
                </item>
                <item>
                    <name>dtsv_file</name>
                    <type>in</type>
                    <content>
                        データサーバ側のファイル名へのポインタ<br/>
                        データサーバ側のファイル名指定について以下に示します。
                        <ul>
                            <li>ASCII文字列を使用して下さい。</li>
                            <li>ファイル名の最後はNULLで終了してください。</li>
                            <li>パスを含めた指定は行えません。<br/>
                               (データサーバのディレクトリ"\NCDATA"に、ファイルが作成されます。)
                            </li>
                            <li>ワイルドカード('*','?')は使用できません。</li>
                            <li>MS-DOS形式にて指定して下さい。<br/>
                                (ファイル名 8文字+'.'+拡張子 3文字+NULLの13文字以内)<br/>
                                〈例〉      "XXXXXXXX.XXX" + NULL<br/>
                                <br/>
                            </li>
                            ただし、現在はＯ番号をファイル名として管理しています。<br/>
                            〈例〉      "O0001" + NULL
                        </ul>
                    </content>
                </item>
                <item>
                    <name>chnl</name>
                    <type>in</type>
                    <content>
                        データサーバのタスクチャンネルの指定<br/>
                        この設定により、データサーバにある８つのタスクチャンネルのうち、パーソナルコンピュータがどのチャンネルを使用してファイルを転送するかを指定します。11から17までの値が指定可能です。<br/>
                        <br/>
                        データサーバは、各種ユーザ(NC、パーソナルコンピュータ、PMC、C言語エグゼキュータ)に対して、最大８つのサービスを行うことができます。データサーバがどのユーザに対してサービスを行うかは、NCパラメータ(No.941〜No.948)に下記のユーザ番号を指定することによって決まります。<br/>
                        <br/>
                        <li>ユーザ番号</li>
                        <table class="dd">
                            <tr><td>0</td><td>：</td><td>無効</td></tr>
                            <tr><td>1</td><td>：</td><td>CNCの第1系統</td></tr>
                            <tr><td>2</td><td>：</td><td>CNCの第2系統</td></tr>
                            <tr><td>3</td><td>：</td><td>CNCの第3系統</td></tr>
                            <tr><td>4</td><td>：</td><td>CNCの第4系統</td></tr>
                            <tr><td>5</td><td>：</td><td>CNCの第5系統</td></tr>
                            <tr><td>6</td><td>：</td><td>CNCの第6系統</td></tr>
                            <tr><td>7</td><td>：</td><td>CNCの第7系統</td></tr>
                            <tr><td>8</td><td>：</td><td>CNCの第8系統</td></tr>
                        </table>
                        <br/>
                        <table class="dd">
                            <tr><td>11</td><td>：</td><td>Open CNC No.1</td></tr>
                            <tr><td>12</td><td>：</td><td>Open CNC No.2</td></tr>
                            <tr><td>13</td><td>：</td><td>Open CNC No.3</td></tr>
                            <tr><td>14</td><td>：</td><td>Open CNC No.4</td></tr>
                            <tr><td>15</td><td>：</td><td>Open CNC No.5</td></tr>
                            <tr><td>16</td><td>：</td><td>Open CNC No.6</td></tr>
                            <tr><td>17</td><td>：</td><td>Open CNC No.7</td></tr>
                        </table>
                        <br/>
                        <table class="dd">
                            <tr><td>21</td><td>：</td><td>PMC</td></tr>
                            <tr><td>31</td><td>：</td><td>C-EXE</td></tr>
                        </table>
                        <br/>
                        <li>CNCﾊﾟﾗﾒｰﾀ 8点(ﾊﾞｲﾄ形)</li>
                        <table class="dd">
                            <tr><td>NO.941</td><td>：</td><td>第1ﾁｬﾝﾈﾙ用</td></tr>
                            <tr><td>NO.942</td><td>：</td><td>第2ﾁｬﾝﾈﾙ用</td></tr>
                            <tr><td>NO.943</td><td>：</td><td>第3ﾁｬﾝﾈﾙ用</td></tr>
                            <tr><td>NO.944</td><td>：</td><td>第4ﾁｬﾝﾈﾙ用</td></tr>
                            <tr><td>NO.945</td><td>：</td><td>第5ﾁｬﾝﾈﾙ用</td></tr>
                            <tr><td>NO.946</td><td>：</td><td>第6ﾁｬﾝﾈﾙ用</td></tr>
                            <tr><td>NO.947</td><td>：</td><td>第7ﾁｬﾝﾈﾙ用</td></tr>
                            <tr><td>NO.948</td><td>：</td><td>第8ﾁｬﾝﾈﾙ用</td></tr>
                        </table>
                        <br/>
                        NCパラメータ(No.941〜No.948)には、前もってユーザ番号を設定しておいて下さい。<br/>
                        (全て無効の場合、CNCの第1系統が第1チャンネルを使用することになります。)<br/>
                        また、この関数を実行すると、関数で使用したチャンネルのモードがストレージモードに変更されます。
                    </content>
                </item>
            </cmn>
        </hssb>
    </argument>



    <!-- 戻り値 -->
    <errcode>
        <item>
            <name>EW_BUSY</name>
            <content>
                ビジィ<br/>
                ・データサーバが処理中なので、リトライして下さい。
            </content>
        </item>
        <item>
            <name>EW_DATA</name>
            <content>
                ファイル名の誤り、ファイルオープンエラー<br/>
                この戻り値に対して、より詳細な情報を得るには<a href="Misc/cnc_getdtailerr.htm" target="_parent">cnc_getdtailerr</a> 関数を実行して下さい。<br/>
                ODBERRのメンバ err_no に下記詳細ステータスがセットされます。<br/>
                <table class="dd">
                    <tr><td>1</td><td>：</td><td>ファイル名 pc_file[] のオープンエラー。</td></tr>
                    <tr><td>2</td><td>：</td><td>ファイル名 pc_file[] の読み込みエラー。</td></tr>
                </table>
            </content>
        </item>
        <item>
            <name>EW_PARAM</name>
            <content>
                タスクチャンネル設定異常<br/>
                ・NCのパラメータ(No.941〜948)に、OpenCNCに対応する11〜17の設定が必要です。
            </content>
        </item>
        <item>
            <name>EW_NUMBER</name>
            <content>
                タスクチャンネル設定異常<br/>
                ・関数において、OpenCNCに対応する11〜17以外の引数の指定がされています。
            </content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>
                オプションなし<br/>
                ・拡張ドライバ/ライブラリ機能が必要です。<br/>
                ・データサーバ機能が必要です。<br/>
                ・データサーバボード(10BASE-T)が必要です。<br/>
                ・ハードディスクが装着されていません。
            </content>
        </item>
        <item>
            <name>EW_DTSRVR</name>
            <content>
                データサーバのエラー<br/>
                この戻り値に対して、より詳細な情報を得るには <a href="misc/cnc_getdtailerr.htm" target="_parent">cnc_getdtailerr</a> 関数を実行して下さい。ODBERR構造体のメンバ err_no に下記詳細ステータスがセットされます。<br/>
                詳しくはイーサネットボード・データサーバボード取扱説明書を参照して下さい。
                <table class="dd">
                    <tr><td>0xf000，0xfe00〜</td><td>:</td><td>データサーバが返すエラーコード</td></tr>
                    <tr><td>1</td>               <td>:</td><td>データサーバの処理タイムアウト</td></tr>
                </table>
            </content>
        </item>
    </errcode>



    <!-- CNCオプション -->
    <option>
        <hssb>拡張ドライバ/ライブラリ機能、データサーバ機能が必要です。</hssb>
    </option>



    <!-- CNCパラメータ -->
    <parameter>
        <dtsv>
            941〜948 (上記ユーザ番号を設定して下さい。)
        </dtsv>
    </parameter>



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



    <!-- 対応機種 -->
    <support>
        <!-- M（ミリング） -->
        <m>
            <fs0ia>X</fs0ia>
            <fs0ib>H</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>H</fs16ia>
            <fs18ia>H</fs18ia>
            <fs21ia>H</fs21ia>
            <fs16ib>H</fs16ib>
            <fs18ib>H</fs18ib>
            <fs21ib>H</fs21ib>
            <fs30i>X</fs30i>
        </m>
        <!-- T（旋盤） -->
        <t>
            <fs0ia>X</fs0ia>
            <fs0ib>H</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>H</fs16ia>
            <fs18ia>H</fs18ia>
            <fs21ia>H</fs21ia>
            <fs16ib>H</fs16ib>
            <fs18ib>H</fs18ib>
            <fs21ib>H</fs21ib>
            <fs30i>X</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>H</fs16i>
            <fs18i>H</fs18i>
        </p>
        <!-- L（レーザ） -->
        <l>
            <fs16i>H</fs16i>
            <fs18i>X</fs18i>
        </l>
        <!-- W（ワイヤカット） -->
        <w>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </w>
        <!-- PM（パワーメート） -->
        <pw>
            <d>X</d>
            <h>X</h>
        </pw>
    </support>



    <reference>
        <item>
            <name>cnc_dtsvrdfile</name>
            <file>Data/cnc_dtsvrdfile.htm</file>
        </item>
    </reference>



  </func>
</root>
