MicroEntry function (wiamicro.h)

Article
02/22/2024

The MicroEntry function responds to commands sent by the WIA Flatbed driver.

Syntax

WIAMICRO_API HRESULT MicroEntry(
            LONG lCommand,
  [in, out] PVAL pValue
);

Parameters

lCommand

Specifies a command issued to the microdriver by the WIA Flatbed driver.

[in, out] pValue

Points to a VAL structure that is used to pass information between the WIA Flatbed driver and the microdriver.

Return value

If the function succeeds, it returns S_OK. If a passed command is not supported, the function returns E_NOTIMPL. For any error, error information must be put in the lVal member of the VAL structure pointed to by pValue.

Remarks

This function performs many different tasks, depending on the command passed in the lCommand parameter. See the WIA Microdriver Commands reference section for a list of these commands.

Two structures are passed to the function. A VAL structure is passed in the pValue pointer, and the pScanInfo member of the VAL structure points to a SCANINFO structure. The VAL structure is used to pass information between the WIA Flatbed Driver and the microdriver. The SCANINFO structure is used to store and communicate parameters of a scan data acquisition. Many of the commands passed to this function set values in the SCANINFO structure.

Requirements

Requirement	Value
Target Platform	Desktop
Header	wiamicro.h (include Wiamicro.h)