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

Статья
02/07/2025

Метод IStillImage::GetDeviceList возвращает аппаратные характеристики для всех установленных устройств образа.

Синтаксис

HRESULT GetDeviceList(
        DWORD  dwType,
        DWORD  dwFlags,
  [out] DWORD  *pdwItemsReturned,
  [out] LPVOID *ppBuffer
);

Параметры

dwType

Зарезервированный параметр, используйте NULL.

dwFlags

Зарезервированный параметр, используйте NULL.

[out] pdwItemsReturned

Получает количество структур STI_DEVICE_INFORMATION, предоставленных в буфере, на который ссылается ppBuffer.

[out] ppBuffer

Получает дескриптор выделенного буфера STI. Этот буфер будет содержать массив структур STI_DEVICE_INFORMATION.

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

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

Замечания

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

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

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

Требования

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

См. также

IStillImage::GetDeviceInfo

IStillImageW

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