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 de STISUBSCRIBE que contém valores de parâmetro de assinatura.
Valor de retorno
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.
Observações
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 de imagem ainda para que 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 do Win32 (por meio de chamadas de 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 do IStiDevice devem chamar IStillImage::CreateDevice para obter um ponteiro de interface IStiDevice, que fornece acesso a um dispositivo especificado.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | sti.h (inclua Sti.h) |