Méthode IStillImageW ::GetSTILaunchInformation (sti.h)

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

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, pour recevoir le nom d’appareil interne de l’appareil d’image fixe pour lequel l’application a été démarrée.

[out, optional] pdwEventCode

Réservé pour un usage futur.

[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 d’image fixe pour lesquels l’application a été démarrée.

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

Si le moniteur d’événements d’image fixe a démarré l’application, les valeurs pwszDeviceName et pwszEventName identifient les arguments de ligne de commande /StiDevice et /StiEvent (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 COM IStillImage doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage .

Configuration requise