Fungsi StiCreateInstanceW (sti.h)

  • Artikel

Fungsi StiCreateInstance membuat instans objek COM yang menentukan antarmuka IStillImage , dan mengembalikan pointer ke antarmuka.

Sintaks

HRESULT StiCreateInstanceW(
  HINSTANCE    hinst,
  DWORD        dwVer,
  IStillImageW **ppSti,
  LPUNKNOWN    punkOuter
);

Parameter

hinst

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

dwVer

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

ppSti

Menerima pointer ke antarmuka IStillImage .

punkOuter

Penunjuk opsional yang disediakan penelepon ke "mengontrol tidak diketahui" untuk agregasi objek. Lihat bagian Keterangan berikut ini.

Nilai kembali

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

Keterangan

Agar aplikasi dapat menggunakan antarmuka IStillImage , aplikasi harus terlebih dahulu memanggil fungsi StiCreateInstance untuk mendapatkan penunjuk ke antarmuka. Pointer yang diterima dalam ppSti kemudian digunakan saat memanggil metode IStillImage , seperti yang diilustrasikan dalam contoh berikut:

PSTI pSti = NULL;
DWORD dwStiTotal = 0;     // total number of STI devices found
PVOID pStiInfo = NULL;    // STI device info buffer
HRESULT hres = StiCreateInstance(GetModuleHandle(NULL), STI_VERSION, &pSti, NULL);
...
hhes = pSti->GetDeviceList(0, 0, &dwStiTotal, &pStiInfo);

Jika Anda ingin membuat objek COM agregat yang menyertakan IStillImage, Anda harus menyediakan pointer ke "mengontrol tidak diketahui" di punkOuter. Dalam kebanyakan kasus, Anda tidak akan membuat objek agregat, jadi punkOuter harus NULL. Agregasi objek dan pengontrol yang tidak diketahui dijelaskan dalam artikel Agregasi dan dalam Spesifikasi Model Objek Komponen.

Persyaratan

Persyaratan Nilai
Header sti.h (termasuk Sti.h)

Lihat juga

IStillImage::Release