IWiaDevMgr2::RegisterEventCallbackInterface-Methode

Artikel
06/13/2023

Registriert eine ausgeführte Anwendung für windows Image Acquisition (WIA) 2.0-Ereignisbenachrichtigungen.

Syntax

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

Parameter

lFlags [in]

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

bstrDeviceID [in]

Typ: BSTR

Gibt den eindeutigen Bezeichner eines WIA 2.0-Geräts an. Legen Sie diesen Parameter auf NULL fest, um sich für das Ereignis auf allen WIA 2.0-Geräten zu registrieren.

pEventGUID [in]

Typ: const GUID*

Gibt einen Zeiger auf den Ereignisbezeichner an, für den sich die Anwendung registriert. Standardereignisbezeichner finden Sie unter WIA-Ereignisbezeichner .

pIWiaEventCallback [in]

Typ: IWiaEventCallback*

Gibt einen Zeiger auf die IWiaEventCallback-Schnittstelle an, die wia 2.0 zum Senden von Ereignisbenachrichtigungen verwendet.

pEventObject [out]

Typ: IUnknown**

Empfängt die Adresse eines Zeigers auf die IUnknown-Schnittstelle .

Rückgabewert

Typ: HRESULT

Gibt die com-Standardfehlercodes oder folgendes zurück.

Rückgabecode	Beschreibung
E_NOTIMPL	Die IUnknown-Schnittstelle kann nicht zurückgegeben werden.

Bemerkungen

Warnung

Die Verwendung der Methoden IWiaDevMgr::RegisterEventCallbackInterface, IWiaDevMgr2::RegisterEventCallbackInterface und DeviceManager.RegisterEvent aus demselben Prozess nach dem Neustart des Still Image-Diensts kann eine Zugriffsverletzung verursachen, wenn die Funktionen vor dem Beenden des Diensts verwendet wurden.

Wenn WIA 2.0-Anwendungen mit der Ausführung beginnen, verwenden sie diese Methode, um sich für den Empfang von Hardwaregeräteereignissen zu registrieren. Dadurch wird verhindert, dass die Anwendung neu gestartet wird, wenn ein anderes Ereignis auftritt, für das sie registriert ist. Sobald eine Anwendung IWiaDevMgr2::RegisterEventCallbackInterface aufruft, um sich zu registrieren, um WIA 2.0-Ereignisse von einem Gerät zu empfangen, werden die registrierten Ereignisse von WIA 2.0 an das Programm weitergeleitet.

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den pEventObject-Parameter empfangen.

Hinweis

In einer Multithreadanwendung kann der Rückruf für Ereignisbenachrichtigungen in einem anderen Thread als in dem Thread erfolgen, der den Rückruf registriert hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Wia.h
IDL	Wia.idl

Freigeben über