IStiDevice ::Subscribe, méthode (sti.h)
La méthode IStiDevice ::Subscribe inscrit l’appelant pour recevoir des notifications d’événements d’appareil.
Syntaxe
HRESULT Subscribe(
[in, out] LPSTISUBSCRIBE lpSubsribe
);
Paramètres
[in, out] lpSubsribe
Pointeur fourni par l’appelant vers une structure STISUBSCRIBE contenant des valeurs de paramètre d’abonnement.
Valeur de retour
Si l’opération réussit, la méthode retourne S_OK. Sinon, elle retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.
Remarques
La méthode IStiDevice ::Subscribe est généralement appelée par les applications qui interceptent les événements à partir d’appareils et les redirigent à nouveau. La méthode permet à ces applications d’être averties de événements still Image Device afin qu’elles puissent ensuite distribuer le contrôle aux applications d’affichage appropriées.
En fonction du contenu fourni dans la structure STISUBSCRIBE, l’appelant peut demander d’être averti des événements d’appareil par les messages Windows ou par des événements Win32 (par le biais de appels setEvent).
Lorsque l’application reçoit la notification d’un événement, elle peut appeler IStiDevice ::GetLastNotificationData pour savoir quel événement s’est produit.
Avant d’appeler IStiDevice ::Subscribe, les clients de l’interface IStiDevice COM doivent appeler IStillImage ::CreateDevice pour obtenir un pointeur d’interface IStiDevice, qui fournit l’accès à un appareil spécifié.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | sti.h (include Sti.h) |