IStillImageW ::SetupDeviceParameters, méthode (sti.h)

La méthode IStillImage ::SetupDeviceParameters permet aux clients de l’interface COM IStillImage de modifier les caractéristiques stockées d’un appareil image fixe, si le type de bus de l’appareil est inconnu.

Syntaxe

HRESULT SetupDeviceParameters(
  [in, out] PSTI_DEVICE_INFORMATIONW unnamedParam1
);

Paramètres

[in, out] unnamedParam1

Définit le paramètre PSTI_DEVICE_INFORMATIONWunnamedParam1.

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 IStillImage ::SetupDeviceParameters autorise uniquement la modification des paramètres d’appareil associés aux appareils d’image fixe pour lesquels aucun bus n’a été identifié. Pour ces appareils, le serveur d’images fixes définit le membre dwHardwareConfiguration de la structure STI_DEVICE_INFORMATION de l’appareil sur STI_HW_CONFIG_UNKNOWN lorsque IStillImage ::GetDeviceInfo est appelé.

Actuellement, le seul paramètre d’appareil qui peut être modifié est le nom de port de l’appareil. Lorsque vous appelez cette méthode pour modifier le nom du port, les membres dwSize, szDeviceInternalName et pszPortName du STI_DEVICE_INFORMATION doivent être spécifiés. Tous les autres membres sont ignorés.

Avant d’appeler IStillImage ::SetupDeviceParameters, les clients de l’interface COM IStillImage doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage .

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	sti.h (inclure Sti.h)