IStiDevice::RawReadData method (sti.h)

Article
02/22/2024

The IStiDevice::RawReadData method reads data from a still image device.

Syntax

HRESULT RawReadData(
  [in, out]      LPVOID       lpBuffer,
  [in, out]      LPDWORD      lpdwNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parameters

[in, out] lpBuffer

Caller-supplied pointer to a buffer to receive data read from the device.

[in, out] lpdwNumberOfBytes

Caller-supplied pointer to a DWORD. The caller must load the DWORD with the number of bytes in the buffer pointed to by lpBuffer. On return, it will contain the number of bytes actually read.

[in, optional] lpOverlapped

Optional, caller-supplied pointer to an OVERLAPPED structure (described in the Microsoft Windows SDK documentation).

Return value

If the operation succeeds, the method returns S_OK. Otherwise, it returns one of the STIERR-prefixed error codes defined in stierr.h.

Remarks

The IStiDevice::RawReadData method calls IStiUSD::RawReadData, which is exported by vendor-supplied minidrivers.

Before calling IStiDevice::RawReadData, clients of the IStiDevice COM interface must call IStillImage::CreateDevice to obtain an IStiDevice interface pointer, which provides access to a specified device.

A call to IStiDevice::RawReadData must be preceded by a call to IStiDevice::LockDevice and followed by a call to IStiDevice::UnLockDevice.

Requirements

Requirement	Value
Target Platform	Desktop
Header	sti.h (include Sti.h)