Fungsi StiCreateInstanceW (sti.h)
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) |