IWiaDevMgr2::RegisterEventCallbackProgram 메서드

IWiaDevMgr2::RegisterEventCallbackProgram 메서드는 디바이스 이벤트를 수신하도록 애플리케이션을 등록합니다. 주로 WIA(Windows Image Acquisition) 2.0용으로 작성되지 않은 애플리케이션과의 이전 버전과의 호환성을 위해 제공됩니다.

구문

HRESULT RegisterEventCallbackProgram(
  [in]       LONG lFlags,
  [in]       BSTR bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in]       BSTR bstrFullAppName,
  [in]       BSTR bstrCommandlineArg,
  [in]       BSTR bstrName,
  [in]       BSTR bstrDescription,
  [in]       BSTR bstrIcon
);

매개 변수

lFlags [in]

형식: LONG

등록 플래그입니다. 다음 값으로 설정할 수 있습니다.

값	의미
WIA_REGISTER_EVENT_CALLBACK	이벤트에 등록합니다.
WIA_UNREGISTER_EVENT_CALLBACK	이벤트에 대한 등록을 삭제합니다.
WIA_SET_DEFAULT_HANDLER	애플리케이션을 기본 이벤트 처리기로 설정합니다.

 

bstrDeviceID [in]

형식: BSTR

디바이스 식별자입니다. NULL을 전달하여 모든 WIA 2.0 디바이스에서 이벤트를 등록합니다.

pEventGUID [in]

형식: const GUID*

애플리케이션이 등록하는 이벤트입니다. 유효한 이벤트 GUID 목록은 WIA 이벤트 식별자를 참조하세요.

bstrFullAppName [in]

형식: BSTR

애플리케이션의 전체 경로 이름입니다.

bstrCommandlineArg [in]

형식: BSTR

애플리케이션에 대한 적절한 명령줄 인수입니다.

bstrName [in]

형식: BSTR

애플리케이션 이름입니다. 여러 애플리케이션이 동일한 이벤트에 등록할 때 이름이 사용자에게 표시됩니다.

bstrDescription [in]

형식: BSTR

애플리케이션의 설명입니다. 설명은 여러 애플리케이션이 동일한 이벤트에 등록할 때 사용자에게 표시됩니다.

bstrIcon [in]

형식: BSTR

애플리케이션을 나타내는 아이콘입니다. 아이콘은 여러 애플리케이션이 동일한 이벤트에 등록할 때 사용자에게 표시됩니다. 문자열에는 애플리케이션의 이름과 쉼표로 구분된 아이콘의 인덱스(예: "MyApp, 0")가 포함됩니다. 애플리케이션을 나타내는 아이콘이 두 개 이상 있을 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

IWiaDevMgr2::RegisterEventCallbackProgram을 사용하여 하드웨어 디바이스 이벤트에 등록합니다. 애플리케이션이 등록되는 이벤트가 발생하면 애플리케이션이 시작되고 이벤트 정보가 애플리케이션으로 전송됩니다.

EnumRegisterEventInfo 메서드를 사용하여 이벤트 등록 속성에 대한 열거자 개체에 대한 포인터를 검색합니다.

WIA 2.0 아키텍처용으로 작성되지 않은 애플리케이션과의 이전 버전과의 호환성을 위해 IWiaDevMgr2::RegisterEventCallbackProgram 메서드만 사용합니다. 새 애플리케이션에 WIA 2.0 아키텍처에서 제공하는 COM(구성 요소 개체 모델) 인터페이스를 사용합니다. 특히 IWiaDevMgr2::RegisterEventCallbackInterface 또는 IWiaDevMgr2::RegisterEventCallbackCLSID 를 호출하여 디바이스 이벤트에 대한 새 애플리케이션을 등록합니다.

일반적으로 이 메서드는 설치 프로그램 또는 스크립트에서 호출됩니다. 설치 프로그램 또는 스크립트는 WIA 2.0 디바이스 이벤트를 수신하도록 애플리케이션을 등록합니다. 이벤트가 발생하면 WIA 2.0 런타임 시스템에서 애플리케이션을 시작합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
헤더	Wia.h