IStiUSD::RawReadData 方法(stiusd.h)

静止图像微型驱动程序的 IStiUSD::RawReadData 方法从静止图像设备读取数据。

语法

HRESULT RawReadData(
  LPVOID       lpBuffer,
  LPDWORD      lpdwNumberOfBytes,
  LPOVERLAPPED lpOverlapped
);

参数

lpBuffer

调用方提供的指向缓冲区的指针,用于接收从设备读取的数据。

lpdwNumberOfBytes

调用方提供的指向 DWORD 的指针。 调用方加载 DWORD,缓冲区中的字节数由 lpBuffer指向。 驱动程序必须将此值替换为实际读取的字节数。

lpOverlapped

可选,调用方提供的指向 OVERLAPPED 结构的指针(Microsoft Windows SDK 文档中所述)。

返回值

如果作成功,该方法应返回S_OK。 否则,它应返回 stierr.h中定义的 STIERR 前缀错误代码之一。

言论

静止图像微型驱动程序通常通过调用 ReadFile(在 Windows SDK 文档中介绍)来实现此方法。

对于 USB 设备,如果读取请求与最大数据包大小边界保持一致,则可以实现更好的性能。 可以通过调用 DeviceIoControl(指定 IOCTL_GET_CHANNEL_ALIGN_RQST I/O 控制代码)来获取最大数据包大小。

要求

要求 价值
目标平台 桌面
标头 stiusd.h (包括 Stiusd.h)

另请参阅

IStiDevice::RawReadData

IStiUSD