CNC_RDPARAM_EXT | NCDATA

Description

Declaration

Arguments

typedef struct iodbprm {
        long datano;        /* parameter number */
        short type;         /* type information */
        short axis;         /* axis information */
        short info;         /* attribute */
        short unit;         /* unit */
        struct {
            long prm_val;   /* parameter value */
            long dec_val;   /* place of decimal point */
        } data[32];
} IODBPRM;

Return

EW_OK is returned on successful completion, otherwise any value except EW_OK is returned.

The major error codes are as follows.

As for the other return codes or the details, see "Return status of Data window function"

CNC option

For HSSB connection,

The extended driver/library function is necessary.

For Ethernet connection,

The Ethernet function and the extended driver/library function are necessary.

However, in case of Series 16i/18i/21i-B, 0i-B/C/D/F, Series 30i and PMi-A, the required CNC option is as follows.

When Embedded Ethernet is used,

above two optional functions are not required.

When Ethernet board is used,

only Ethernet function is required.

CNC parameter

This function is not related to CNC parameter.

CNC mode

This function can be used in any CNC mode.

Available CNC

Note) 0i-C does not support the HSSB function.

See Also

cnc_rdparam   cnc_wrparam   cnc_rdparar   cnc_wrparas   cnc_rdparainfo   cnc_rdparanum  

Example(C Language)

The following program reads the parameter No.20 and No.1020, and displays them.

#include "fwlib32.h"

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

        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 );
        }
}

Example(C#)

The following program reads the parameter No.20 and No.1020, and displays them.

class example
{
    public void sample()
    {
            Focas1.IODBPRM2 prm = new Focas1.IODBPRM2();
            int[]  prmno = new int[2];
            short ret;

            byte[] bytes = new byte[Marshal.SizeOf(prm) * 2];
            IntPtr ptrWork = Marshal.AllocCoTaskMem(Marshal.SizeOf(prm));

            prmno[0] = 20;
            prmno[1] = 1020;
            ret = Focas1.cnc_rdparam_ext(h, prmno, 2, bytes);
            if (ret == Focas1.EW_OK)
            {
                    int pos = 0;
                    Marshal.Copy(bytes, pos, ptrWork, Marshal.SizeOf(prm));
                    Marshal.PtrToStructure(ptrWork, prm);

                    Console.WriteLine("No.20: = {0}", prm.data.data1.prm_val);

                    pos += Marshal.SizeOf(prm);
                    Marshal.Copy(bytes, pos, ptrWork, Marshal.SizeOf(prm));
                    Marshal.PtrToStructure(ptrWork, prm);

                    Console.WriteLine("No.1020:");
                    Console.WriteLine("  1st axis = {0}", prm.data.data1.prm_val);
                    Console.WriteLine("  2nd axis = {0}", prm.data.data2.prm_val);
                    Console.WriteLine("  3rd axis = {0}", prm.data.data3.prm_val);
            }
            Marshal.FreeCoTaskMem(ptrWork);
    }
}