Metodo IStiDevice::Subscribe (sti.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | sti.h (include Sti.h) |