iStiDevice::RawReadCommand 方法 (sti.h)
IStiDevice::RawReadCommand 方法會從仍在映像裝置讀取命令資訊。
語法
HRESULT RawReadCommand(
[in, out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwNumberOfBytes,
[in, optional] LPOVERLAPPED lpOverlapped
);
參數
[in, out] lpBuffer
呼叫端提供的緩衝區指標,以接收從裝置讀取的數據。
[in, out] lpdwNumberOfBytes
呼叫端提供的 DWORD 指標。 呼叫端必須載入 DWORD,緩衝區中由 lpBuffer 指向的位元組數目。 傳回時,它將會包含實際讀取的位元元組數目。
[in, optional] lpOverlapped
選擇性、呼叫端提供的重疊結構指標, (Microsoft Windows SDK 檔) 中所述。
傳回值
如果作業成功,方法會傳回S_OK。 否則,它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。
備註
IStiDevice::RawReadCommand 方法會呼叫由廠商提供的迷你驅動程序導出的 IStiUSD::RawReadCommand。 緩衝區內容的意義是廠商定義的。
只有在不同方法從裝置讀取命令和數據資訊時,才需要呼叫 IStiDevice::RawReadCommand 。 針對其他裝置, IStiDevice::RawReadData 可用於命令和數據。
呼叫 IStiDevice::RawReadCommand 之前, IStiDevice COM 介面的客戶端必須呼叫 IStillImage::CreateDevice 以取得 IStiDevice 介面指標,以提供指定裝置的存取權。
呼叫 IStiDevice::RawReadCommand 之前必須呼叫 IStiDevice::LockDevice,後面接著呼叫 IStiDevice::UnLockDevice。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | sti.h (包含 Sti.h) |