IStiUSD::Escape 方法 (stiusd.h)
静态图像微型驱动程序的 IStiUSD::Escape 方法在静止图像设备上执行特定于供应商的 I/O 操作。
语法
HRESULT Escape(
STI_RAW_CONTROL_CODE EscapeFunction,
LPVOID lpInData,
DWORD cbInDataSize,
LPVOID pOutData,
DWORD cbOutDataSize,
LPDWORD pdwActualData
);
参数
EscapeFunction
调用方提供的、供应商定义的、表示 I/O 操作的 DWORD 大小的值。 供应商定义的值必须大于 Sti.h 中定义的 STI_RAW_RESERVED。
lpInData
调用方提供的指针,指向包含发送到设备的数据的缓冲区。
cbInDataSize
lpInData 指向的缓冲区的调用方提供的长度(以字节为单位)。
pOutData
调用方提供的指向内存缓冲区的指针,用于从设备接收数据。
cbOutDataSize
lpOutData 指向的缓冲区的调用方提供的长度(以字节为单位)。
pdwActualData
接收实际写入 pOutData 的字节数。
返回值
如果操作成功,方法应返回S_OK。 否则,它应返回 stierr.h 中定义的 STIERR 前缀错误代码之一。 如果未实现方法,则它应返回STIERR_UNSUPPORTED。
注解
如果 IStiUSD::RawReadData、IStiUSD::RawWriteData、IStiUSD::RawReadCommand 或 IStiUSD::RawWriteCommand 方法中无法实现的 I/O 操作,则静态图像微型驱动程序只需要实现 IStiUSD::Escape。 微型驱动程序定义 IStiUSD::Escape 的参数用法。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | stiusd.h (包括 Stiusd.h) |