Метод IStillImageW::LaunchApplicationForDevice (sti.h)

Статья
02/07/2025

Метод IStillImage::LaunchApplicationForDevice запускает указанное приложение для указанного устройства по-прежнему изображения.

Синтаксис

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

Параметры

[in] pwszDeviceName

Указатель на строку, представляющую внутреннее имя устройства, полученную путем вызова IStillImage::GetSTILaunchInformation или IStillImage::GetDeviceList.

[in] pwszAppName

Вызывающий указатель на строку, представляющую короткое имя приложения, зарегистрированного путем вызова IStillImage::RegisterLaunchApplication.

[in] pStiNotify

Вызывающий указатель на структуру STINOTIFY, описывающую событие устройства. Как правило, GUID события получается путем вызова IStiDevice::GetLastNotificationData.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Замечания

Метод IStillImage::LaunchApplicationForDevice может запускать только приложения, зарегистрированные путем вызова IStillImage::RegisterLaunchApplication. Указанное событие должно быть одним из поддерживаемых указанным устройством. Метод имитирует вхождение события устройства и полезен для приложений, которые перехватывают события с устройств и перенаправляет их. Когда пользователь запускает сканер, такое приложение может, например, попросить пользователя сохранить отсканированное изображение, сделать копию или отправить факс.

Перед вызовом IStillImage::LaunchApplicationForDeviceклиенты интерфейса IStillImage COM должны вызывать IStillImage::StiCreateInstance для получения указателя интерфейса IStillImage.

Примеры

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	sti.h (include Sti.h)

Поделиться через