IStiDevice ::Initialize, méthode (sti.h)

Cette méthode est réservée à un usage interne uniquement.

La méthode IStiDevice ::Initialize initialise un instance de l’objet COM qui définit l’interface IStiDevice.

Syntaxe

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

Paramètres

[in] hinst

Instance de gestion du processus d’appel fourni par l’appelant. Ce handle est obtenu en appelant GetModuleName(NULL).

[in] pwszDeviceName

Pointeur fourni par l’appelant vers une chaîne représentant un nom d’appareil interne, obtenue en appelant IStillImage ::GetSTILaunchInformation.

dwVersion

Numéro de version STI fourni par l’appelant. Cette valeur doit être STI_VERSION, définie dans Sti.h.

dwMode

Valeur constante fournie par l’appelant indiquant les modes de transfert dans lesquels l’appareil doit être utilisé. Les valeurs suivantes sont valides.

Valeur retournée

Si l’opération réussit, la méthode retourne S_OK. Sinon, il retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

La méthode IStiDevice ::Initialize initialise l’objet COM instance qui a été créé en appelant IStillImage ::CreateDevice.

Étant donné qu’IStiDevice ::Initialize est appelé par IStillImage ::CreateDevice, les clients de l’interface IStiDevice n’appellent généralement pas cette méthode directement.

Configuration requise