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

Статья
02/07/2025

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

Синтаксис

HRESULT RawReadCommand(
  [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::RawReadCommand вызывает вызовы IStiUSD::RawReadCommand, который экспортируется поставщиками мини-drivers. Значение содержимого буфера определяется поставщиком.

Необходимо вызывать только IStiDevice::RawReadCommand, если данные команды и данных считываются с устройства различными методами. Для других устройств IStiDevice::RawReadData можно использовать как для команд, так и для данных.

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

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

Требования

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

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