Método IStillImageW::LaunchApplicationForDevice (sti.h)

El método IStillImage::LaunchApplicationForDevice inicia una aplicación especificada para un dispositivo de imagen fija especificado.

Sintaxis

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

Parámetros

[in] pwszDeviceName

Puntero proporcionado por el llamador a una cadena que representa un nombre de dispositivo interno, obtenido llamando a IStillImage::GetSTILaunchInformation o IStillImage::GetDeviceList.

[in] pwszAppName

Puntero proporcionado por el autor de la llamada a una cadena que representa el nombre corto de una aplicación registrada mediante una llamada a IStillImage::RegisterLaunchApplication.

[in] pStiNotify

Puntero proporcionado por el autor de la llamada a una estructura STINOTIFY que describe un evento de dispositivo. Normalmente, el GUID del evento se obtiene mediante una llamada a IStiDevice::GetLastNotificationData.

Valor devuelto

Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Comentarios

El método IStillImage::LaunchApplicationForDevice solo puede iniciar aplicaciones que se hayan registrado por sí mismas llamando a IStillImage::RegisterLaunchApplication. El evento especificado debe ser uno que admita el dispositivo especificado. El método imita la aparición de un evento de dispositivo y es útil para las aplicaciones que interceptan eventos de dispositivos y los vuelven a enrutar. Cuando un usuario inicia el escáner, tal aplicación podría, por ejemplo, preguntar al usuario si desea almacenar la imagen escaneada, hacer una copia o enviar un fax.

Antes de llamar a IStillImage::LaunchApplicationForDevice, los clientes de la interfaz COM IStillImage deben llamar a IStillImage::StiCreateInstance para obtener un puntero de interfaz IStillImage .

Ejemplos

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

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	sti.h (include Sti.h)