cmmUtlWriteUserTable


SYNOPSIS

VT_I4 cmmUtlWriteUserTable(
    [in] VT_I4 nAddress, [in] VT_I4 nSize,
    [in] UCHAR * pBuffer
    )

DESCRIPTION

  • 이 함수는 cmmUtlWriteUserTable() 함수를 통하여 CMMSDK 에서 제공하는 사용자 데이터 테이블에 기록한 데이터를 읽어들이는 함수입니다.

  • CMMSDK 에서 제공하는 사용자 데이터 테이블은 COMI-LX5xx 장치의 드라이버에서 제공하는 적은양의 메모리 공간을 의미합니다.

  • COMI-LX5xx 장치의 드라이버 프로그램은 윈도우 O/S 가 부팅될 때 자동으로 실행되어서 윈도우가 종료될 때까지 실행 상태를 유지합니다. 따라서 CMMSDK 를 사용하는 응용프로그램이 종료되었다가 다시 실행되어도 사용자 데이터 테이블은 이전의 상태를 그대로 유지하게 됩니다. 그러므로 CMMSDK 에서 제공하는 사용자 데이터 테이블은 윈도우 O/S 가 실행되고 있는 동안에는 응용프로그램 입장에서는 비휘발성 메모리와 같은 역할을 수행하다가 윈도우 O/S 가 재부팅되면 그 값이 리셋되는 특성을 가지는 데이터 저장 공간으로 생각하면 됩니다.

  • 사용자가 사용할 수 있는 사용자 테이블의 크기는 장치 하나당 100 바이트 입니다.

PARAMETER

  • nAddress : 읽고자하는 사용자 데이터 테이블의 주소값을 지정합니다. 모션 장치 하나에서 제공하는 Address 크기는 100(0~99)입니다. 만일 모션 장치가 2 개가 있다면 Address 범위는 200(0~199)가 되고, 모션 장치가 N 개 있다면 Address 범위는 N*100 이 됩니다.

  • nSize : 읽고자하는 데이터블럭의 크기를 바이트 단위로 지정합니다. 이 값은 100 보다 작거나 같아야 합니다.

  • pBuffer : 읽은 데이터를 전달받을 버퍼를 지정합니다. 이 버퍼의 크기는 nSize 보다 크거나 같아야 합니다.

RETURN VALUE

Value

Meaning

음수

수행 실패

cmERR_NONE

수행 성공