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