Función wiasQueueEvent (wiamdef.h)
La función wiasQueueEvent informa al servicio de que el dispositivo generó un evento.
Sintaxis
HRESULT wiasQueueEvent(
[in] BSTR bstrDeviceId,
[in] const GUID *pEventGUID,
[in, optional] BSTR bstrFullItemName
);
Parámetros
[in] bstrDeviceId
Especifica el identificador de dispositivo. Este es el valor pasado al minidriver en la llamada al método IWiaMiniDrv::d rvInitializeWia.
[in] pEventGUID
Puntero a un búfer que contiene el GUID del evento.
[in, optional] bstrFullItemName
Especifica el nombre completo del elemento, incluida la información de ruta de acceso.
Valor devuelto
Si la función se ejecuta correctamente, devuelve S_OK.
Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error WIA.
Observaciones
Este método debe usarse siempre que el dispositivo debe indicar que se produjo un evento de algún tipo. El dispositivo lo hace colocando el evento en la cola de eventos. Por ejemplo, cuando una cámara toma una nueva imagen, debe generar un evento WIA_EVENT_ITEM_CREATED después de agregar un nuevo elemento de controlador a su árbol. La cámara puede colocar este evento en la cola de eventos de esta manera:
hr = wiasQueueEvent(bstrMyDeviceId,
&WIA_EVENT_ITEM_CREATED,
bstrDescriptionString);
Consulte la documentación de Windows SDK para obtener una lista completa de identificadores de eventos WIA.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wiamdef.h (incluya Wiamdef.h) |
| biblioteca de | Wiaservc.lib |
| DLL de | Wiaservc.dll |