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

Article
02/07/2025

Cette méthode est destinée uniquement à une utilisation interne.

La méthode IStiDevice ::Initialize initialise une 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

Handle d’instance fourni par l’appelant du processus 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 obtenu 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.

Mode	Description
STI_DEVICE_CREATE_BOTH	L’appareil est ouvert pour obtenir l’état et transférer des données.
STI_DEVICE_CREATE_DATA	L’appareil est ouvert uniquement pour les transferts de données.
STI_DEVICE_CREATE_STATUS	L’appareil est ouvert uniquement pour obtenir des informations d’état.

Valeur de retour

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

Remarques

La méthode IStiDevice ::Initialize initialise l’instance d’objet COM créée en appelant IStillImage ::CreateDevice.

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

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	sti.h (include Sti.h)

Partager via