Метод IStiUSD::Escape (stiusd.h)
Метод IStiUSD::Escape мини-драйвера для неподвижного образа выполняет операцию ввода-вывода конкретного поставщика на устройстве с неподвижным изображением.
Синтаксис
HRESULT Escape(
STI_RAW_CONTROL_CODE EscapeFunction,
LPVOID lpInData,
DWORD cbInDataSize,
LPVOID pOutData,
DWORD cbOutDataSize,
LPDWORD pdwActualData
);
Параметры
EscapeFunction
Предоставленное вызывающим, определяемое поставщиком значение размера DWORD, представляющее операцию ввода-вывода. Значения, определяемые поставщиком, должны быть больше STI_RAW_RESERVED, которые определены в Sti.h.
lpInData
Предоставленный вызывающим объектом указатель на буфер, содержащий данные, отправленные на устройство.
cbInDataSize
Предоставленная вызывающим объектом длина буфера, на который указывает lpInData, в байтах.
pOutData
Предоставленный вызывающим объектом указатель на буфер памяти для получения данных с устройства.
cbOutDataSize
Предоставленная вызывающим объектом длина буфера, на который указывает lpOutData, в байтах.
pdwActualData
Получает количество байтов, фактически записанных в pOutData.
Возвращаемое значение
Если операция выполнена успешно, метод должен вернуть S_OK. В противном случае он должен вернуть один из кодов ошибок с префиксом STIERR, определенных в stierr.h. Если метод не реализован, он должен вернуть STIERR_UNSUPPORTED.
Комментарии
Мини-диск для неподвижного образа должен реализовывать только IStiUSD::Escape , если требуются операции ввода-вывода, которые не могут быть реализованы в методах IStiUSD::RawReadData, IStiUSD::RawWriteData, IStiUSD::RawReadCommand или IStiUSD::RawWriteCommand . Мини-диск определяет использование параметра для IStiUSD::Escape.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | stiusd.h (включая Stiusd.h) |