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

Article
02/07/2025

La méthode IStillImage ::LaunchApplicationForDevice démarre une application spécifiée pour un appareil toujours spécifié.

Syntaxe

HRESULT LaunchApplicationForDevice(
  [in] LPWSTR      pwszDeviceName,
  [in] LPWSTR      pwszAppName,
  [in] LPSTINOTIFY pStiNotify
);

Paramètres

[in] pwszDeviceName

Pointeur fourni par l’appelant vers une chaîne représentant un nom d’appareil interne, obtenu en appelant IStillImage ::GetSTILaunchInformation ou IStillImage ::GetDeviceList.

[in] pwszAppName

Pointeur fourni par l’appelant vers une chaîne représentant le nom court d’une application inscrite en appelant IStillImage ::RegisterLaunchApplication.

[in] pStiNotify

Pointeur fourni par l’appelant vers une structure STINOTIFY décrivant un événement d’appareil. En règle générale, le GUID de l’événement est obtenu en appelant IStiDevice ::GetLastNotificationData.

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 IStillImage ::LaunchApplicationForDevice ne peut démarrer que les applications qui se sont inscrites eux-mêmes en appelant IStillImage ::RegisterLaunchApplication. L’événement spécifié doit être celui pris en charge par l’appareil spécifié. La méthode imite l’occurrence d’un événement d’appareil et est utile pour les applications qui interceptent les événements des appareils et les redirigent à nouveau. Lorsqu’un utilisateur démarre le scanneur, une telle application peut, par exemple, demander à l’utilisateur s’il souhaite stocker l’image numérisée, effectuer une copie ou envoyer une télécopie.

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

Exemples

HRESULT hRes;
hRes = pStiDevice->GetLastNotificationData(&pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->GetLastNotificationData returned %xh %u",
        hReturn,hReturn);
}

// Process or filter events here

// Send event on to app
hRes = pSti->LaunchApplicationForDevice(pStiInfoPtr->szDeviceInternalName,
     L"AppName",
     pNotify);
if (!SUCCEEDED(hRes))
{
    DisplayOutput("->LaunchApplicationForDevice on %S returned %xh %u",
        pStiInfoPtr->szDeviceInternalName,hReturn,hReturn);
}

Exigences

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

Partager via