Метод IStillImageW::SetupDeviceParameters (sti.h)

Статья
02/07/2025

Метод IStillImage::SetupDeviceParameters позволяет клиентам интерфейса IStillImage COM изменять сохраненные характеристики устройства, если тип шины устройства неизвестен.

Синтаксис

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

Параметры

[in, out] unnamedParam1

Определяет параметр PSTI_DEVICE_INFORMATIONWunnamedParam1.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Замечания

Метод IStillImage::SetupDeviceParameters позволяет изменять параметры устройства, связанные с устройствами с изображением, для которых шина не была идентифицирована. Для таких устройств сервер образов по-прежнему задает dwHardwareConfiguration член структуры STI_DEVICE_INFORMATION устройства STI_HW_CONFIG_UNKNOWN при вызове IStillImage::GetDeviceInfo.

В настоящее время единственным параметром устройства, который можно изменить, является имя порта устройства. При вызове этого метода для изменения имени порта необходимо указать dwSize, szDeviceInternalNameи pszPortName членов STI_DEVICE_INFORMATION. Все остальные члены игнорируются.

Перед вызовом IStillImage::SetupDeviceParametersклиенты интерфейса IStillImage IStillImage должны вызывать IStillImage::StiCreateInstance для получения указателя интерфейса IStillImage.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	sti.h (include Sti.h)

Поделиться через