Compartir a través de


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 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)

Consulte también

IStiDevice

IStiDevice::UnSubscribe

IStillImage::LaunchApplicationForDevice