Método IStiDevice::Subscribe (sti.h)
O método IStiDevice::Subscribe registra o chamador para receber notificações de eventos do dispositivo.
Sintaxe
HRESULT Subscribe(
[in, out] LPSTISUBSCRIBE lpSubsribe
);
Parâmetros
[in, out] lpSubsribe
Ponteiro fornecido pelo chamador para uma estrutura STISUBSCRIBE que contém valores de parâmetro de assinatura.
Retornar valor
Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.
Comentários
O método IStiDevice::Subscribe normalmente é chamado por aplicativos que interceptam eventos de dispositivos e os redirecionam. O método permite que esses aplicativos sejam notificados sobre eventos de dispositivo still image para que eles possam expedir o controle para aplicativos de exibição apropriados.
Com base no conteúdo fornecido na estrutura STISUBSCRIBE , o chamador pode solicitar a notificação de eventos do dispositivo por mensagens do Windows ou por eventos Win32 (por meio de chamadas SetEvent ).
Quando o aplicativo recebe a notificação de um evento, ele pode chamar IStiDevice::GetLastNotificationData para descobrir qual evento ocorreu.
Antes de chamar IStiDevice::Subscribe, os clientes da interface COM IStiDevice devem chamar IStillImage::CreateDevice para obter um ponteiro de interface IStiDevice , que fornece acesso a um dispositivo especificado.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | sti.h (inclua Sti.h) |