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

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

Требования

См. также раздел

IStillImage::GetDeviceList

IStillImageW