IWiaDevMgr2::RegisterEventCallbackInterface 메서드

  • 아티클

WIA(Windows Image Acquisition) 2.0 이벤트 알림을 위해 실행 중인 애플리케이션을 등록합니다.

구문

HRESULT RegisterEventCallbackInterface(
  [in]        LONG              lFlags,
  [in]        BSTR              bstrDeviceID,
  [in]  const GUID              *pEventGUID,
  [in]        IWiaEventCallback *pIWiaEventCallback,
  [out]       IUnknown          **pEventObject
);

매개 변수

lFlags [in]

형식: LONG

현재 사용되지 않습니다. 0으로 설정해야 합니다.

bstrDeviceID [in]

형식: BSTR

WIA 2.0 디바이스의 고유 식별자를 지정합니다. 모든 WIA 2.0 디바이스에서 이벤트에 등록하려면 이 매개 변수를 NULL 로 설정합니다.

pEventGUID [in]

형식: const GUID*

애플리케이션이 등록하는 이벤트 식별자에 대한 포인터를 지정합니다. 표준 이벤트 식별자는 WIA 이벤트 식별자를 참조하세요.

pIWiaEventCallback [in]

형식: IWiaEventCallback*

WIA 2.0에서 이벤트 알림을 보내는 데 사용하는 IWiaEventCallback 인터페이스에 대한 포인터를 지정합니다.

pEventObject [out]

형식: IUnknown**

IUnknown 인터페이스에 대한 포인터의 주소를 받습니다.

반환 값

형식: HRESULT

표준 COM 오류 코드 또는 다음을 반환합니다.

반환 코드 설명
E_NOTIMPL
 IUnknown 인터페이스를 반환할 수 없습니다.

 

설명

경고

스틸 이미지 서비스를 다시 시작한 후 동일한 프로세스에서 IWiaDevMgr::RegisterEventCallbackInterface, IWiaDevMgr2::RegisterEventCallbackInterface 및 DeviceManager.RegisterEvent 메서드를 사용하면 서비스가 중지되기 전에 함수를 사용한 경우 액세스 위반이 발생할 수 있습니다.

 

WIA 2.0 애플리케이션이 실행되기 시작하면 이 메서드를 사용하여 하드웨어 디바이스 이벤트를 수신하도록 등록합니다. 이렇게 하면 등록된 다른 이벤트가 발생할 때 애플리케이션이 다시 시작되지 않습니다. 애플리케이션이 IWiaDevMgr2::RegisterEventCallbackInterface 를 호출하여 디바이스에서 WIA 2.0 이벤트를 수신하도록 등록하면 등록된 이벤트가 WIA 2.0에 의해 프로그램으로 라우팅됩니다.

애플리케이션은 pEventObject 매개 변수를 통해 수신하는 인터페이스 포인터에서 IUnknown::Release 메서드를 호출해야 합니다.

참고

다중 스레드 애플리케이션에서 이벤트 알림 콜백은 콜백을 등록한 스레드와 다른 스레드에 들어올 수 있습니다.

 

요구 사항

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