wiasQueueEvent-Funktion (wiamdef.h)

Die wiasQueueEvent-Funktion informiert den Dienst darüber, dass das Gerät ein Ereignis generiert hat.

Syntax

HRESULT wiasQueueEvent(
  [in]           BSTR       bstrDeviceId,
  [in]           const GUID *pEventGUID,
  [in, optional] BSTR       bstrFullItemName
);

Parameter

[in] bstrDeviceId

Gibt die Geräte-ID an. Dies ist der Wert, der im Aufruf der IWiaMiniDrv::d rvInitializeWia-Methode an den Minidriver übergeben wird.

[in] pEventGUID

Zeiger auf einen Puffer, der die GUID für das Ereignis enthält.

[in, optional] bstrFullItemName

Gibt den vollständigen Elementnamen an, einschließlich Pfadinformationen.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.

Hinweise

Diese Methode sollte immer dann verwendet werden, wenn das Gerät signalisieren muss, dass ein Ereignis eines bestimmten Typs aufgetreten ist. Dazu platziert das Gerät das Ereignis in der Ereigniswarteschlange. Wenn eine Kamera beispielsweise ein neues Bild aufnimmt, sollte sie ein WIA_EVENT_ITEM_CREATED-Ereignis generieren, nachdem sie ihrer Struktur ein neues Treiberelement hinzugefügt hat. Die Kamera kann dieses Ereignis auf folgende Weise in der Ereigniswarteschlange platzieren:

hr = wiasQueueEvent(bstrMyDeviceId,
                    &WIA_EVENT_ITEM_CREATED,
                    bstrDescriptionString);

Eine vollständige Liste der WIA-Ereignisbezeichner finden Sie in der Windows SDK-Dokumentation.

Anforderungen

Weitere Informationen

IWiaMiniDrv::d rvInitializeWia