IStiUSD::RawReadData 方法 (stiusd.h)
仍為影像 minidriver 的 IStiUSD::RawReadData 方法會從仍在影像裝置讀取數據。
語法
HRESULT RawReadData(
LPVOID lpBuffer,
LPDWORD lpdwNumberOfBytes,
LPOVERLAPPED lpOverlapped
);
參數
lpBuffer
呼叫端提供的緩衝區指標,以接收從裝置讀取的數據。
lpdwNumberOfBytes
呼叫端提供的 DWORD 指標。 呼叫端會載入 DWORD,其中包含 lpBuffer 所指向之緩衝區中的位元組數目。 驅動程式必須將此值取代為實際讀取的位元組數目。
lpOverlapped
選擇性、呼叫端提供的重疊結構指標, (Microsoft Windows SDK 檔) 中所述。
傳回值
如果作業成功,方法應該會傳回S_OK。 否則,它應該會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。
備註
仍為 image minidriver 通常會呼叫 Windows SDK 檔) 中所述的 ReadFile (來實作此方法。
對於USB裝置,如果讀取要求符合封包大小上限界限,則可以達到更好的效能。 呼叫 DeviceIoControl 以取得封包大小上限,指定 IOCTL_GET_CHANNEL_ALIGN_RQST I/O 控制程式代碼。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | stiusd.h (包含 Stiusd.h) |