Metodo IStiDevice::Subscribe (sti.h)

Articolo
08/07/2023

Il metodo IStiDevice::Subscribe registra il chiamante per ricevere notifiche degli eventi del dispositivo.

Sintassi

HRESULT Subscribe(
  [in, out] LPSTISUBSCRIBE lpSubsribe
);

Parametri

[in, out] lpSubsribe

Puntatore fornito dal chiamante a una struttura STISUBSCRIBE contenente i valori dei parametri della sottoscrizione.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Il metodo IStiDevice::Subscribe viene in genere chiamato dalle applicazioni che intercettano gli eventi dai dispositivi e li reindirizzano. Il metodo consente a queste applicazioni di ricevere una notifica degli eventi del dispositivo ancora immagine in modo che possano quindi inviare il controllo alle applicazioni di visualizzazione appropriate.

In base al contenuto fornito nella struttura STISUBSCRIBE , il chiamante può richiedere di ricevere una notifica degli eventi del dispositivo dai messaggi di Windows o dagli eventi Win32 (tramite chiamate SetEvent ).

Quando l'applicazione riceve una notifica di un evento, può chiamare IStiDevice::GetLastNotificationData per scoprire quale evento si è verificato.

Prima di chiamare IStiDevice::Subscribe, i client dell'interfaccia COM IStiDevice devono chiamare IStillImage::CreateDevice per ottenere un puntatore all'interfaccia IStiDevice , che fornisce l'accesso a un dispositivo specificato.