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
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | wiamdef.h (einschließlich Wiamdef.h) |
Bibliothek | Wiaservc.lib |
DLL | Wiaservc.dll |