IWiaDevMgr2::RegisterEventCallbackInterface-Methode
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 |
|---|---|
|
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 |
|
| IDL |
|