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

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

  • Статья

Метод IStiDevice::RawWriteCommand отправляет сведения о команде на устройство неподвижного образа.

Синтаксис

HRESULT RawWriteCommand(
  [in]           LPVOID       lpBuffer,
                 DWORD        nNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Параметры

[in] lpBuffer

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

nNumberOfBytes

Указанное вызывающим абонентом число записываемых байтов. Это число байтов в буфере, на который указывает lpBuffer.

[in, optional] lpOverlapped

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

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

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

Комментарии

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

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

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

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

Требования

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