Metodo IStillImageW::LaunchApplicationForDevice (sti.h)

Il metodo IStillImage::LaunchApplicationForDevice avvia un'applicazione specificata per un dispositivo ancora immagine specificato.

Sintassi

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

Parametri

[in] pwszDeviceName

Puntatore fornito dal chiamante a una stringa che rappresenta un nome di dispositivo interno, ottenuto chiamando IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.

[in] pwszAppName

Puntatore fornito dal chiamante a una stringa che rappresenta il nome breve di un'applicazione registrata chiamando IStillImage::RegisterLaunchApplication.

[in] pStiNotify

Puntatore fornito dal chiamante a una struttura STINOTIFY che descrive un evento del dispositivo. In genere, il GUID dell'evento viene ottenuto chiamando IStiDevice::GetLastNotificationData.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Il metodo IStillImage::LaunchApplicationForDevice può avviare solo le applicazioni registrate chiamando IStillImage::RegisterLaunchApplication. L'evento specificato deve essere uno supportato dal dispositivo specificato. Il metodo simula l'occorrenza di un evento del dispositivo ed è utile per le applicazioni che intercettano gli eventi dai dispositivi e li reindirizzano. Quando un utente avvia lo scanner, un'applicazione di questo tipo potrebbe, ad esempio, chiedere all'utente se archiviare l'immagine analizzata, creare una copia o inviare un fax.

Prima di chiamare IStillImage::LaunchApplicationForDevice, i client dell'interfaccia COM IStillImage devono chiamare IStillImage::StiCreateInstance per ottenere un puntatore all'interfaccia IStillImage .

Esempio

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);
}

Requisiti