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
呼叫端提供的廠商定義、DWORD 大小值,代表 I/O 作業。 廠商定義的值必須大於 Sti.h 中定義的STI_RAW_RESERVED。
lpInData
呼叫端提供的緩衝區指標,其中包含傳送至裝置的數據。
cbInDataSize
呼叫端提供的緩衝區長度,以位元組為單位,由 lpInData 所指向。
pOutData
呼叫端提供的記憶體緩衝區指標,以接收來自裝置的數據。
cbOutDataSize
呼叫端提供的緩衝區長度,以位元組為單位,由 lpOutData 所指向。
pdwActualData
接收實際寫入 pOutData 的位元元組數目。
傳回值
如果作業成功,方法應該會傳回S_OK。 否則,它應該會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。 如果未實作 方法,它應該會傳回STIERR_UNSUPPORTED。
備註
如果 I/O 作業無法在 IStiUSD::RawReadData、IStiUSD::RawWriteData、IStiUSD::RawWriteData、IStiUSD::RawReadCommand 或 IStiUSD::RawWriteCommand 方法內實作,仍需要實作 IStiUSD::Escape。 minidriver 會定義 IStiUSD::Escape 的參數使用方式。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | stiusd.h (包含 Stiusd.h) |