Funzione StiCreateInstanceW (sti.h)

Articolo
03/05/2024

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)

Vedi anche

IStillImage::Release