IStillImageW::Metode GetSTILaunchInformation (sti.h)

Metode IStillImage::GetSTILaunchInformation mengembalikan alasan aplikasi gambar diam panggilan dimulai, jika pemantau peristiwa gambar diam memulainya.

Sintaks

HRESULT GetSTILaunchInformation(
  [out]           LPWSTR pwszDeviceName,
  [out, optional] DWORD  *pdwEventCode,
  [out]           LPWSTR pwszEventName
);

Parameter

[out] pwszDeviceName

Penunjuk yang disediakan penelepon ke buffer, panjangnya STI_MAX_INTERNAL_NAME_LENGTH byte, untuk menerima nama perangkat internal perangkat gambar diam tempat aplikasi dimulai.

[out, optional] pdwEventCode

Disiapkan untuk penggunaan masa mendatang.

[out] pwszEventName

Penunjuk yang disediakan penelepon ke buffer yang cukup besar untuk menerima representasi string GUID. GUID mewakili Peristiwa Perangkat Gambar Diam tempat aplikasi dimulai.

Mengembalikan nilai

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

Keterangan

Jika monitor peristiwa gambar diam memulai aplikasi, nilai pwszDeviceName dan pwszEventName mengidentifikasi argumen baris perintah /StiDevice dan /StiEvent (lihat deskripsi IStillImage::RegisterLaunchApplication). Jika pemantau peristiwa tidak memulai aplikasi, metode mengembalikan STIERR_GENERIC.

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

Persyaratan

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