Metodo IStiDevice::Initialize (sti.h)

Questo metodo è solo per uso interno.

Il metodo IStiDevice::Initialize inizializza un'istanza dell'oggetto COM che definisce l'interfaccia IStiDevice .

Sintassi

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

Parametri

[in] hinst

Gestione dell'istanza fornita dal chiamante del processo di chiamata. Questo handle viene ottenuto chiamando GetModuleName(NULL).

[in] pwszDeviceName

Puntatore fornito dal chiamante a una stringa che rappresenta un nome di dispositivo interno, ottenuto chiamando IStillImage::GetSTILaunchInformation.

dwVersion

Numero di versione STI fornito dal chiamante. Questo valore deve essere STI_VERSION, definito in Sti.h.

dwMode

Valore costante fornito dal chiamante che indica le modalità di trasferimento in cui deve essere usato il dispositivo. I valori seguenti sono validi.

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

Il metodo IStiDevice::Initialize inizializza l'istanza dell'oggetto COM creata chiamando IStillImage::CreateDevice.

Poiché IStiDevice::Initialize viene chiamato da IStillImage::CreateDevice, i client dell'interfaccia IStiDevice non chiamano in genere direttamente questo metodo.

Requisiti