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 오류 코드 또는 다음을 반환합니다.
반환 코드 | 설명 |
---|---|
|
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 [데스크톱 앱만 해당] |
헤더 |
|
IDL |
|