Méthode IStiDevice ::Subscribe (sti.h)

Article
02/29/2024

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é.