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

呼叫端提供的廠商定義、DWORD 大小值，代表 I/O 作業。 裝置的迷你驅動程式必須辨識此值，而且必須匯出 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。 裝置的minidriver會定義 Method 參數使用方式。

呼叫 IStiDevice：：Escape 之前， IStiDevice COM 介面的客戶端必須呼叫 IStillImage：：CreateDevice 以取得 IStiDevice 介面指標，以提供指定裝置的存取權。

對 IStiDevice：：Escape 的呼叫之前，必須先呼叫 IStiDevice：：LockDevice，後面接著呼叫 IStiDevice：：UnLockDevice。

規格需求

需求	值
目標平台	桌面
標頭	sti.h (包含 Sti.h)