3.2.3. ecGn_SetEnableTimerResolSet


SYNOPSYS

t_success ecGn_SetEnableTimerResolSet(
  t_bool IsEnable,
  t_i32 *ErrCode)

DESCRIPTION

  • 라이브러리 내부에서 Sleep()을 적용할 때 타이머 분해능을 1msec로 조절할지를 설정합니다.

  • ecmSxMot_Move 함수와 같이 함수 내부에서 특정 조건이 만족될 때까지 기다리는 함수에서는 기다리는 동안에 다른 쓰레드나 프로세스에 부하를 주지 않기 위해서 Sleep() 함수를 사용합니다. 그런데 Sleep(1)과 같이 1msec의 Sleep을 실행하였더라도 현재 설정된 윈도우 타이머의 분해능에 따라서 Sleep(1)이 최대 16msec까지 지연을 시킬 수도 있습니다.

  • 이를 방지하기 위해서는 타이머 분해능을 1msec로 설정해야 합니다.

PARAMETER

  • IsEnable : 분해능을 1msec로 조정하는 기능의 활성화 여부. 이 설정은 기본적으로 1로 설정되어 있습니다.

Value

Meaning

Default

0

윈도우 타이머 분해능을 조정하지 않음

1

Sleep()을 실행할 때에 윈도우 타이머를 1msec로 정함

Y

  • ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.

RETURN VALUE

  • 함수 수행의 성공 여부를 반환합니다.

Value

Meaning

0

함수 수행에 실패 하였음을 의미합니다.

1

함수 수행에 성공 하였음을 의미합니다

REFERENCE

  • 분해능 1msec 설정 기능을 활성화 하였어도 ComiECAT SDK에서 Sleep()을 사용할 때에만 윈도우 타이머 분해능을 1msec로 설정하고, Sleep() 루틴이 끝나면 다시 원래의 분해능으로 복원합니다.