IWiaEventCallback::ImageEventCallback-Methode (wia_xp.h)

Die IWiaEventCallback::ImageEventCallback-Methode wird vom Windows Image Acquisition(WIA)-Laufzeitsystem aufgerufen, wenn ein Hardwaregeräteereignis auftritt.

Syntax

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

Parameter

[in] pEventGUID

Typ: const GUID*

Gibt den eindeutigen Bezeichner des Ereignisses an. Eine vollständige Liste der Geräteereignisse finden Sie unter WIA-Ereignisbezeichner.

[in] bstrEventDescription

Typ: BSTR

Gibt die Zeichenfolgenbeschreibung des Ereignisses an.

[in] bstrDeviceID

Typ: BSTR

Gibt den eindeutigen Bezeichner des WIA-Geräts an.

[in] bstrDeviceDescription

Typ: BSTR

Gibt die Zeichenfolgenbeschreibung des Geräts an.

[in] dwDeviceType

Art: DWORD

Gibt den Typ des Geräts an. Eine Liste der möglichen Werte finden Sie unter WIA-Gerätetypspezifizierer .

[in] bstrFullItemName

Typ: BSTR

Gibt den vollständigen Namen des WIA-Elements an, das das Gerät darstellt.

[in, out] pulEventType

Typ: ULONG*

Zeiger auf eine ULONG , die angibt, ob ein Ereignis ein Benachrichtigungsereignis, ein Aktionsereignis oder beides ist. Der Wert 1 gibt ein Benachrichtigungsereignis an, der Wert 2 ein Aktionsereignis und der Wert 3 gibt an, dass das Ereignis sowohl vom Benachrichtigungs- als auch vom Aktionstyp ist.

[in] ulReserved

Typ: ULONG

Reserviert für Benutzerinformationen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Um Benachrichtigungen über WIA-Hardwaregeräteereignisse zu erhalten, übergeben Anwendungen einen Zeiger auf die IWiaEventCallback-Schnittstelle auf die RegisterEventCallbackInterface-Methode . Das WIA-Laufzeitsystem verwendet dann diesen Schnittstellenzeiger, um die IWiaEventCallback::ImageEventCallback-Methode aufzurufen, wenn ein WIA-Hardwaregeräteereignis auftritt.

Beachten Sie, dass es keine Garantie gibt, dass der Rückruf in demselben Thread aufgerufen wird, der die IWiaEventCallback-Schnittstelle registriert hat.

Anforderungen