Metodo IStiDevice::Initialize (sti.h)

Articolo
02/07/2025

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

Handle di istanza fornito dal chiamante del processo chiamante. 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 il modalità di trasferimento in cui deve essere usato il dispositivo. I valori seguenti sono validi.

Modo	Descrizione
STI_DEVICE_CREATE_BOTH	Il dispositivo viene aperto sia per ottenere lo stato che per il trasferimento dei 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.

Osservazioni

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 questo metodo direttamente.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	sti.h (include Sti.h)

Condividi tramite