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

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

  • Статья

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

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

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

Комментарии

Метод IStiDevice::RawReadCommand вызывает IStiUSD::RawReadCommand, который экспортируется предоставленными поставщиком мини-накопителями. Значение содержимого буфера определяется поставщиком.

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

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

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

Требования

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