Метод IStiDevice::Initialize (sti.h)
Этот метод предназначен только для внутреннего использования.
Метод 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) |