Funzione StiCreateInstanceW (sti.h)
La funzione StiCreateInstance crea un'istanza dell'oggetto COM che definisce l'interfaccia IStillImage e restituisce un puntatore all'interfaccia.
Sintassi
HRESULT StiCreateInstanceW(
HINSTANCE hinst,
DWORD dwVer,
IStillImageW **ppSti,
LPUNKNOWN punkOuter
);
Parametri
hinst
Handle di istanza fornito dal chiamante del processo chiamante. Questo handle viene ottenuto chiamando GetModuleHandle(NULL).
dwVer
Numero di versione STI fornito dal chiamante. Questo valore deve essere STI_VERSION, definito in Sti.h.
ppSti
Riceve un puntatore all'interfaccia IStillImage .
punkOuter
Puntatore fornito dal chiamante facoltativo al "controllo sconosciuto" per l'aggregazione di oggetti. Vedere la sezione Osservazioni seguente.
Valore restituito
Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.
Commenti
Affinché un'applicazione usi l'interfaccia IStillImage , deve prima chiamare la funzione StiCreateInstance per ottenere un puntatore all'interfaccia. Il puntatore ricevuto in ppSti viene usato successivamente quando si chiamano i metodi IStillImage , come illustrato nell'esempio seguente:
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);
Se si vuole creare un oggetto COM aggregato che include IStillImage, è necessario fornire un puntatore al "controllo sconosciuto" in punkOuter. Nella maggior parte dei casi non si creerà un oggetto aggregato, quindi punkOuter dovrebbe essere NULL. L'aggregazione di oggetti e il controllo sconosciuto sono descritti nell'articolo Aggregazione e nella specifica del modello a oggetti del componente.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | sti.h (include Sti.h) |