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

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

  • Статья

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

Синтаксис

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 клиенты COM-интерфейса IStillImage должны вызвать IStillImage::StiCreateInstance , чтобы получить указатель интерфейса IStillImage .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть sti.h (включая Sti.h)