STI_DEV_CAPS structure (sti.h)

Article
02/22/2024

The STI_DEV_CAPS structure is used as a parameter to the IStiDevice::GetCapabilities method. It is also a member of the STI_DEVICE_INFORMATION and STI_WIA_DEVICE_INFORMATION structures.

Syntax

typedef struct _STI_DEV_CAPS {
  DWORD dwGeneric;
} STI_DEV_CAPS, *PSTI_DEV_CAPS;

Members

dwGeneric

Contains bit flags identifying device capabilities. The following flags are defined.

STI_GENCAP_AUTO_PORTSELECT

The driver is capable of determining which LPT or COM port the device is connected to. If this flag is set, the user can select "Auto" for the port during device installations, and the driver must determine the port.

STI_GENCAP_GENERATE_ARRIVALEVENT

The still image server will generate a GUID_DeviceArrivedLaunch event when the device is successfully initialized, typically in response to PnP arrival. (Events are not generated by the servers initial enumeration, to avoid end-user confusion.)

STI_GENCAP_NOTIFICATIONS

The device supports event notifications (either asynchronously or through polling), and the device can be subscribed to (see IStiDevice::Subscribe).

STI_GENCAP_POLLING_NEEDED

The device is not capable of issuing asynchronous notifications; polling of the device is required (see IStiDevice::GetStatus).

STI_GENCAP_SUBSET

A driver with more features exists. An IHV driver with a full set of features should not have this bit set.

STI_GENCAP_WIA

The user-mode still image driver is WIA-capable.

The values assigned to these flags are based on registry contents that the Capabilities entry for the device's setup information (INF) file supplies. See INF Files for Still Image Devices.

Requirements

Requirement	Value
Header	sti.h (include Sti.h)

Share via