Méthode IStiDevice ::Subscribe (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ètres d’abonnement.
Valeur retournée
Si l’opération réussit, la méthode retourne S_OK. Sinon, il 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 des appareils et les redirigent. La méthode permet à ces applications d’être informées des événements d’appareil image fixe 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 à être averti des événements d’appareil par des messages Windows ou par des événements Win32 (au moyen d’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 COM IStiDevice doivent appeler IStillImage ::CreateDevice pour obtenir un pointeur d’interface IStiDevice , qui fournit l’accès à un appareil spécifié.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | sti.h (inclure Sti.h) |