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)