Метод IStillImageW::GetDeviceList (sti.h)
Метод 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 клиенты COM-интерфейса IStillImage должны вызвать IStillImage::StiCreateInstance , чтобы получить указатель интерфейса IStillImage .
Когда вызывающий объект завершит использование массива STI_DEVICE_INFORMATION структур, на которые ссылается ppBuffer, он должен освободить массив, вызвав Метод LocalFree (описано в документации по Microsoft Windows SDK).
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | sti.h (включая Sti.h) |