Метод IStiDevice::RawReadData (sti.h)

Статья
02/07/2025

Метод IStiDevice::RawReadData считывает данные с устройства по-прежнему изображения.

Синтаксис

HRESULT RawReadData(
  [in, out]      LPVOID       lpBuffer,
  [in, out]      LPDWORD      lpdwNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Параметры

[in, out] lpBuffer

Вызывающий указатель на буфер для получения данных, считываемых с устройства.

[in, out] lpdwNumberOfBytes

Указатель на DWORD, предоставленный вызывающим абонентом. Вызывающий объект должен загрузить DWORD с количеством байтов в буфере, на который указывает lpBuffer. При возврате он будет содержать количество байтов, которые фактически считываются.

[in, optional] lpOverlapped

Необязательный, предоставленный вызывающим указателем на структуру OVERLAPPED (описанную в документации по пакету SDK для Microsoft Windows).

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

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

Замечания

Метод IStiDevice::RawReadData вызывает вызовы IStiUSD::RawReadData, экспортируемые поставщиками мини-drivers.

Перед вызовом IStiDevice::RawReadDataклиенты интерфейса IStiDevice COM-интерфейсу должны вызывать IStillImage::CreateDevice, чтобы получить указатель интерфейса IStiDevice, который предоставляет доступ к указанному устройству.

Вызов IStiDevice::RawReadData должен предшествовать вызову IStiDevice::LockDevice и вызову IStiDevice::UnLockDevice.

Требования

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

См. также

IStiDevice

IStiDevice::RawReadCommand

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