Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 de 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.
Observaciones
El método IStiDevice::Subscribe normalmente lo llaman las aplicaciones que interceptan eventos de dispositivos y los vuelven a enrutar. El método permite que estas aplicaciones se notifiquen de 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 de STISUBSCRIBE, el autor de la llamada puede solicitar recibir notificaciones de eventos de dispositivo por mensajes de Windows o por eventos Win32 (mediante llamadas a SetEvent).
Cuando la aplicación recibe una notificación de un evento, puede llamar a IStiDevice::GetLastNotificationData para averiguar qué evento se produjo.
Antes de llamar a IStiDevice::Subscribe, los clientes de la interfaz IStiDevice COM deben llamar a IStillImage::CreateDevice para obtener un puntero de interfaz IStiDevice, que proporciona acceso a un dispositivo especificado.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Escritorio |
encabezado de | sti.h (include Sti.h) |