Edit

STI_DEVICE_INFORMATIONW structure (sti.h)

  • Article

The STI_DEVICE_INFORMATION structure is used as an output parameter for the IStillImage::GetDeviceList and IStillImage::GetDeviceInfo functions. It is used as an input parameter for IStillImage::SetupDeviceParameters.

Syntax

typedef struct _STI_DEVICE_INFORMATIONW {
  DWORD           dwSize;
  STI_DEVICE_TYPE DeviceType;
  WCHAR           szDeviceInternalName[STI_MAX_INTERNAL_NAME_LENGTH];
  STI_DEV_CAPS    DeviceCapabilities;
  DWORD           dwHardwareConfiguration;
  LPWSTR          pszVendorDescription;
  LPWSTR          pszDeviceDescription;
  LPWSTR          pszPortName;
  LPWSTR          pszPropProvider;
  LPWSTR          pszLocalName;
} STI_DEVICE_INFORMATIONW, *PSTI_DEVICE_INFORMATIONW;

Members

dwSize

Caller-supplied size, in bytes, of the STI_DEVICE_INFORMATION structure.

DeviceType

An STI_DEVICE_TYPE-typed value identifying the still image device type.

szDeviceInternalName[STI_MAX_INTERNAL_NAME_LENGTH]

Character array containing the device's internal name string. The string can have at most STI_MAX_INTERNAL_NAME_LENGTH characters, including the terminating null character. STI_MAX_INTERNAL_NAME_LENGTH is defined in Sti.h.

DeviceCapabilities

Structure of type STI_DEV_CAPS.

dwHardwareConfiguration

Type of bus connection. The following constants are defined in Sti.h:

STI_HW_CONFIG_PARALLEL

STI_HW_CONFIG_SCSI

STI_HW_CONFIG_SERIAL

STI_HW_CONFIG_USB

STI_HW_CONFIG_UNKNOWN

pszVendorDescription

Pointer to a vendor identification string, obtained from the INF Manufacturer Section of the device's INF file.

pszDeviceDescription

Pointer to a device description string, obtained from the INF Models Section of the device's INF file.

pszPortName

Pointer to a string identifying the device's port.

pszPropProvider

Pointer to a string containing the file name and entry point of a DLL for adding device-specific property sheet pages to Control Panel. Obtained from the PropertyPages entry in the device's INF file.

pszLocalName

Pointer to the local device name the user supplied during installation, for use in displays.

Requirements

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