IStillImageW ::GetSTILaunchInformation, méthode (sti.h)

Article
02/07/2025

La méthode IStillImage ::GetSTILaunchInformation retourne la raison pour laquelle l’application d’image appelante a été démarrée, si le moniteur d’événements d’image toujours l’a démarré.

Syntaxe

HRESULT GetSTILaunchInformation(
  [out]           LPWSTR pwszDeviceName,
  [out, optional] DWORD  *pdwEventCode,
  [out]           LPWSTR pwszEventName
);

Paramètres

[out] pwszDeviceName

Pointeur fourni par l’appelant vers une mémoire tampon, STI_MAX_INTERNAL_NAME_LENGTH octets de longueur, pour recevoir le nom d’appareil interne de l’appareil toujours image pour lequel l’application a démarré.

[out, optional] pdwEventCode

Réservé pour une utilisation ultérieure.

[out] pwszEventName

Pointeur fourni par l’appelant vers une mémoire tampon suffisamment grande pour recevoir une représentation sous forme de chaîne d’un GUID. Le GUID représente les événements d’appareil still image pour lesquels l’application a démarré.

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

Si le moniteur d’événements toujours image a démarré l’application, les valeurs pwszDeviceName et pwszEventName identifient les /StiDevice et /StiEvent arguments de ligne de commande (voir la description de IStillImage ::RegisterLaunchApplication). Si le moniteur d’événements n’a pas démarré l’application, la méthode retourne STIERR_GENERIC.

Avant d’appeler IStillImage ::GetSTILaunchInformation, les clients de l’interface IStillImage COM doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	sti.h (include Sti.h)

Partager via