iStiDevice::Escape 方法 (sti.h)
IStiDevice::Escape 方法将供应商特定的 I/O 操作请求发送到静止映像设备。
语法
HRESULT Escape(
[in] STI_RAW_CONTROL_CODE EscapeFunction,
[in] LPVOID lpInData,
DWORD cbInDataSize,
[in, out] LPVOID pOutData,
DWORD dwOutDataSize,
[out] LPDWORD pdwActualData
);
参数
[in] EscapeFunction
调用方提供的、供应商定义的、表示 I/O 操作的 DWORD 大小的值。 设备的微型驱动程序必须识别此值,并且必须导出 IStiUSD 接口。 供应商定义的值必须大于 Sti.h 中定义的 STI_RAW_RESERVED。
[in] lpInData
调用方提供的指向缓冲区的指针,该缓冲区包含要发送到设备的数据。
cbInDataSize
lpInData 指向的缓冲区中包含的数据的调用方提供的长度(以字节为单位)。
[in, out] pOutData
调用方提供的指向内存缓冲区的指针,用于从设备接收数据。
dwOutDataSize
lpOutData 指向的缓冲区的调用方提供的长度(以字节为单位)。
[out] pdwActualData
接收实际写入 pOutData 的字节数。
返回值
如果操作成功,该方法将返回S_OK。 否则,它将返回 stierr.h 中定义的以 STIERR 为前缀的错误代码之一。
注解
IStiDevice::Escape 方法调用由供应商提供的微型驱动程序导出的 IStiUSD::Escape。 设备的微型驱动程序定义 Method 参数用法。
在调用 IStiDevice::Escape 之前, IStiDevice COM 接口的客户端必须调用 IStillImage::CreateDevice 以获取 IStiDevice 接口指针,该指针提供对指定设备的访问。
调用 IStiDevice::Escape 之前必须先调用 IStiDevice::LockDevice ,然后调用 IStiDevice::UnLockDevice。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | sti.h (包括 Sti.h) |