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

Actuellement, le seul paramètre d’appareil qui peut être modifié est le nom du port de l’appareil. Lors de l’appel de cette méthode pour modifier le nom du port, les dwSize, szDeviceInternalNameet pszPortName membres 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 IStillImage COM doivent appeler IStillImage ::StiCreateInstance pour obtenir un pointeur d’interface IStillImage.

Exigences

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