COMI_US_RetrvChannel¶
SYNOPSYS¶
ULONG COMI_US_RetrvChannel (HANDLE hDevice, int chOrder, ULONG startCount,
int maxNumData, void *pDestBuf, TVarType VarType)
DESCRIPTION¶
이 함수는 A/D Scan 채널 중에서 하나의 채널에 대한 데이터 블럭을 voltage 값으로 환산하여 전달합니다. 데이터 블럭은 사용자가 지정한 startCount 에서부터 maxNumData 에서 지정한 수만큼이 됩니다.
PARAMETER¶
▶ hDevice : 디바이스 핸들값입니다. 이 값은 COMI_LoadDevice() 함수에 의해 얻어진 값이어야 합니다.
▶ chOrder : 데이터를 취하기 원하는 채널의 채널 리스트 상의 순서(0 Based) 입니다. 이 값은 채널 번호가 아님을 주의하여야 합니다.
▶ startCount : 전달 받고자 하는 데이터 블럭의 시작 Scan Count.
▶ maxNumData : 전달 받고자 하는 데이터 블럭의 크기(데이터 수) 를 지정 합니다. 이 값이 양수이면 startCount 부터 이후에 스캔된 데이터 중 maxNumData 에서 지정한 수 만큼 데이터를 전달합니다. 이 값이 음수이면 StartCount 부터 이전에 스캔된 데이터 중 maxNUmData 에서 지정한 수 만큼 데이터를 전달합니다.
▶ pDestBuf : 데이터를 전달 받을 버퍼 포인터를 지정합니다. 이 버퍼의 데이터형은 VarType 파라미터에서 지정한데이터형과 일치해야 합니다. 또한 이 버퍼의 크기는 maxNumData 에서 지정한 값보다 크거나 같아야 한다.
▶ VarType : pDestBuf 의 데이터 형을 지정합니다. 이 값은 다음의 값 중 하나이어야 합니다.
VT_SHORT => pDestBuf 가 short 형 포인터임을 의미하며, 데이터는 Voltage 로 환산되기 이전의 정수형 값으로 전달됩니다.
VT_FLOAT => pDestBuf 가 float 형 포인터임을 의미합니다. 데이터는 Voltage 값으로 전달됩니다.
VT_DOUBLE => pDestBuf 가 double 형 포인터임을 의미합니다. 데이터는 Voltage 값으로 전달됩니다.
RETURN VALUE¶
실제 전달된 데이터 수. 만일 startCount 이후에 현재까지 스캔된 데이터 수가 maxNumData 에서 지정한 수 보다 작으면, 현재 스캔된 데이터까지만 전달하게됩니다.
Device¶
지원 디바이스: COMI-CP101, COMI-CP201, COMI-SD101, COMI-SD102, COMI-SD103, COMI-SD104, COMI-SD201