cmmIntHandlerSetup

SYNOPSIS

VT_I4 cmmIntHandlerSetup(
    [in] VT_I4 HandlerType, [in] VT_HANDLE Handler,
    [in] VT_UI4 nMessage, [in] VT_HANDLE IParam
    )

DESCRIPTION

  • 인터럽트 이벤트 핸들러를 등록합니다. CMMSDK 에서는 윈도우 메시지 방식, 이벤트 객체 방식, 콜백 함수 방식등의 인터럽트 처리를 수행할 수 있으며, 해당 인터럽트가 발생되었을 때, 지정된 HandlerType 에 따른 처리가 이루어지게 됩니다. 이벤트 처리에 대한 보다 자세한 정보는 ㈜ 커미조아 CMMSDK 에서 제공하는 예제 프로그램의 실제 코드를 통해서 확인하시는 것도 좋은 방법입니다.

PARAMETER

  • HandlerType : 인터럽트 핸들러의 종류를 지정합니다. 이 값의 종류는 아래와 같이 3 가지로 지정할 수 있습니다

Value

Meaning

0 (cmIHT_MESSAGE)
윈도우 메시지 전달방식을 통하여 인터럽트를 통지합니다.

  • 장점: GUI 관련 작업을 이벤트핸들러에서 직접 수행할 수 있다.

  • 단점: 윈도우가 메시지루프 상황에 따라서 상당한 지연시간을 가질 수 있다.

1 (cmIHT_EVENT)
이벤트 객체를 통하여 인터럽트를 통지합니다.

  • 장점: 메시지 전달 방식보다 비교적 적은 지연시간을 가질 수 있다.

  • 단점: 사용하기가 복잡하다.

2 (cmIHT_CALLBACK)

콜백 함수를 통하여 인터럽트를 통지합니다. 이 방식이 가장 권장되는 방식입니다. • 장점: 메시지 전달의 지연시간이 3 가지 방식 중에서 가장 적다. • 단점: GUI 관련 작업을 수행할 수 없다.

  • Handler : 이 매개변수의 의미는 HandlerType 의 설정에 따라서 다음과 같이 달라집니다.

HandlerType 설정값

Handler 매개변수의 의미

0 (메시지 방식) 일때

Handler 매개변수는 윈도우 핸들을 의미합니다.

1 (이벤트 방식) 일때

Handler 매개변수는 이벤트 객체를 의미합니다.

2 (콜백 방식) 일때

Handler 매개변수는 콜백 함수를 의미합니다.

RETURN VALUE

Value

Meaning

음수

수행 실패

cmERR_NONE

수행 성공