Метод IStiDevice::Initialize (sti.h)

Статья
02/07/2025

Этот метод предназначен только для внутреннего использования.

Метод IStiDevice::Initialize инициализирует экземпляр COM-объекта, который определяет интерфейс IStiDevice.

Синтаксис

HRESULT Initialize(
  [in] HINSTANCE hinst,
  [in] LPCWSTR   pwszDeviceName,
       DWORD     dwVersion,
       DWORD     dwMode
);

Параметры

[in] hinst

Дескриптор вызываемого экземпляра вызывающего процесса. Этот дескриптор получается путем вызова GetModuleName(NULL).

[in] pwszDeviceName

Указатель на строку, представляющую внутреннее имя устройства, полученную путем вызова IStillImage::GetSTILaunchInformation.

dwVersion

Номер версии STI, предоставленный вызывающим абонентом. Это значение должно быть STI_VERSION, определенное в Sti.h.

dwMode

Вызываемое константное значение, указывающее режимы передачи, в которых используется устройство. Допустимы следующие значения.

Режим	Описание
STI_DEVICE_CREATE_BOTH	Устройство открывается как для получения состояния, так и для передачи данных.
STI_DEVICE_CREATE_DATA	Устройство открыто только для передачи данных.
STI_DEVICE_CREATE_STATUS	Устройство открыто только для получения сведений о состоянии.

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

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

Замечания

Метод IStiDevice::Initialize инициализирует экземпляр COM-объекта, созданный путем вызова IStillImage::CreateDevice.

Так как IStiDevice::Initialize вызывается IStillImage::CreateDevice, клиенты интерфейса IStiDevice обычно не вызывают этот метод напрямую.

Требования

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

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