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


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

Метод 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, предоставленный вызывающим абонентом (описан в документации по Microsoft Windows SDK).

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

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

Комментарии

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

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

Перед вызовом IStiDevice::RawReadData должен предшествовать вызов IStiDevice::LockDevice , а затем вызов IStiDevice::UnLockDevice.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть sti.h (включая Sti.h)

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

IStiDevice

IStiDevice::RawReadCommand