Metode IStiDevice::Initialize (sti.h)

Metode ini hanya untuk penggunaan internal.

Metode IStiDevice::Initialize menginisialisasi instans objek COM yang menentukan antarmuka IStiDevice .

Sintaks

HRESULT Initialize(
  [in] HINSTANCE hinst,
  [in] LPCWSTR   pwszDeviceName,
       DWORD     dwVersion,
       DWORD     dwMode
);

Parameter

[in] hinst

Penanganan instans yang disediakan penelepon dari proses panggilan. Handel ini diperoleh dengan memanggil GetModuleName(NULL).

[in] pwszDeviceName

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

dwVersion

Nomor versi STI yang disediakan penelepon. Nilai ini harus STI_VERSION, yang ditentukan dalam Sti.h.

dwMode

Nilai konstanta yang disediakan penelepon menunjukkan Mode Transfer tempat perangkat akan digunakan. Nilai berikut ini valid.

Mode	Deskripsi
STI_DEVICE_CREATE_BOTH	Perangkat sedang dibuka untuk mendapatkan status dan mentransfer data.
STI_DEVICE_CREATE_DATA	Perangkat sedang dibuka hanya untuk transfer data.
STI_DEVICE_CREATE_STATUS	Perangkat sedang dibuka hanya untuk mendapatkan informasi status.

Mengembalikan nilai

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 IStiDevice::Initialize menginisialisasi instans objek COM yang dibuat dengan memanggil IStillImage::CreateDevice.

Karena IStiDevice::Initialize dipanggil oleh IStillImage::CreateDevice, klien antarmuka IStiDevice biasanya tidak memanggil metode ini secara langsung.

Persyaratan

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