Метод IStiUSD::RawReadCommand (stiusd.h)
Метод IStiUSD::RawReadCommand мини-драйвера для неподвижного образа считывает сведения о команде с устройства неподвижного образа.
Синтаксис
HRESULT RawReadCommand(
LPVOID lpBuffer,
LPDWORD lpdwNumberOfBytes,
LPOVERLAPPED lpOverlapped
);
Параметры
lpBuffer
Предоставленный вызывающим объектом указатель на буфер для получения данных, считываемых с устройства.
lpdwNumberOfBytes
Указатель на DWORD, предоставленный вызывающим. Вызывающий объект загружает DWORD с количеством байтов в буфере, на который указывает lpBuffer. Драйвер должен заменить это значение числом фактически прочитанных байтов.
lpOverlapped
Необязательный указатель на структуру OVERLAPPED, предоставленный вызывающим абонентом (описан в документации по Microsoft Windows SDK).
Возвращаемое значение
Если операция выполнена успешно, метод должен вернуть S_OK. В противном случае он должен вернуть один из кодов ошибок с префиксом STIERR, определенных в stierr.h.
Комментарии
Реализовать IStiUSD::RawReadCommand необходимо только в том случае, если сведения о командах и данных считываются с устройства разными методами. Для других устройств IStiUSD::RawReadData можно использовать как для команд, так и для данных. Если вызов не реализован, он должен вернуть STIERR_UNSUPPORTED.
Реализация этого метода, а также значение содержимого буфера, определяются поставщиком.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | stiusd.h (включая Stiusd.h) |