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 的指针。 调用方必须使用 lpBuffer 指向的缓冲区中的字节数加载 DWORD。 返回时,它将包含实际读取的字节数。

[in, optional] lpOverlapped

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

返回值

如果操作成功,该方法将返回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)