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.

Mode	Descrizione
STI_DEVICE_CREATE_BOTH	Il dispositivo viene aperto per ottenere lo stato e trasferire i dati.
STI_DEVICE_CREATE_DATA	Il dispositivo viene aperto solo per i trasferimenti di dati.
STI_DEVICE_CREATE_STATUS	Il dispositivo viene aperto solo per ottenere informazioni sullo stato.

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

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	sti.h (include Sti.h)