IStiDevice ::Initialize, méthode (sti.h)
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) |