Método IStiDevice::Subscribe (sti.h)
El método IStiDevice::Subscribe registra al autor de la llamada para recibir notificaciones de eventos de dispositivo.
Sintaxis
HRESULT Subscribe(
[in, out] LPSTISUBSCRIBE lpSubsribe
);
Parámetros
[in, out] lpSubsribe
Puntero proporcionado por el autor de la llamada a una estructura STISUBSCRIBE que contiene valores de parámetro de suscripción.
Valor devuelto
Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.
Comentarios
Normalmente, las aplicaciones llaman al método IStiDevice::Subscribe que interceptan eventos de los dispositivos y los vuelven a enrutar. El método permite que estas aplicaciones se notifiquen a los eventos de dispositivo still image para que puedan enviar el control a las aplicaciones de visualización adecuadas.
En función del contenido proporcionado en la estructura STISUBSCRIBE , el autor de la llamada puede solicitar recibir notificaciones de eventos de dispositivo por mensajes de Windows o por eventos win32 (mediante llamadas SetEvent ).
Cuando la aplicación recibe una notificación de un evento, puede llamar a IStiDevice::GetLastNotificationData para averiguar qué evento se ha producido.
Antes de llamar a IStiDevice::Subscribe, los clientes de la interfaz COM IStiDevice deben llamar a IStillImage::CreateDevice para obtener un puntero de interfaz IStiDevice , que proporciona acceso a un dispositivo especificado.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | sti.h (include Sti.h) |