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


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

Метод IStillImage::GetDeviceInfo возвращает характеристики оборудования для указанного устройства по-прежнему.

Синтаксис

HRESULT GetDeviceInfo(
  [in]  LPWSTR pwszDeviceName,
  [out] LPVOID *ppBuffer
);

Параметры

[in] pwszDeviceName

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

[out] ppBuffer

Получает дескриптор в структуру STI_DEVICE_INFORMATION.

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

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

Замечания

Метод IStillImage::GetDeviceInfo возвращает структуру STI_DEVICE_INFORMATION для указанного устройства по-прежнему. Содержимое структуры обычно используется для создания отображения пользовательского интерфейса.

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

Когда вызывающий объект завершит использование структуры STI_DEVICE_INFORMATION, на которую ссылается ppBuffer, он должен освободить буфер путем вызова LocalFree (описано в документации по пакету SDK для Microsoft Windows).

Требования

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

См. также

IStillImage::GetDeviceList

IStillImageW