IStillImageW::LaunchApplicationForDevice method (sti.h)

Metode IStillImage::LaunchApplicationForDevice memulai aplikasi tertentu untuk perangkat gambar diam tertentu.

Sintaks

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

Parameter

[in] pwszDeviceName

Penunjuk yang disediakan penelepon ke string yang mewakili nama perangkat internal, diperoleh dengan memanggil IStillImage::GetSTILaunchInformation atau IStillImage::GetDeviceList.

[in] pwszAppName

Penunjuk yang disediakan penelepon ke string yang mewakili nama pendek aplikasi yang terdaftar dengan memanggil IStillImage::RegisterLaunchApplication.

[in] pStiNotify

Penunjuk yang disediakan penelepon ke struktur STINOTIFY yang menjelaskan peristiwa perangkat. Biasanya, GUID peristiwa diperoleh dengan memanggil IStiDevice::GetLastNotificationData.

Nilai kembali

Jika operasi berhasil, metode akan mengembalikan S_OK. Jika tidak, ia mengembalikan salah satu kode kesalahan berawalan STIERR yang ditentukan dalam stierr.h.

Keterangan

Metode IStillImage::LaunchApplicationForDevice hanya dapat memulai aplikasi yang telah mendaftarkan diri dengan memanggil IStillImage::RegisterLaunchApplication. Peristiwa yang ditentukan harus salah satu yang didukung perangkat yang ditentukan. Metode ini meniru terjadinya peristiwa perangkat, dan berguna untuk aplikasi yang mencegat peristiwa dari perangkat dan mengalihkannya. Ketika pengguna memulai pemindai, aplikasi seperti itu mungkin, misalnya, bertanya kepada pengguna apakah mereka ingin menyimpan gambar yang dipindai, membuat salinan, atau mengirim faks.

Sebelum memanggil IStillImage::LaunchApplicationForDevice, klien antarmuka IStillImage COM harus memanggil IStillImage::StiCreateInstance untuk mendapatkan penunjuk antarmuka IStillImage .

Contoh

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

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	sti.h (termasuk Sti.h)