Skip to content

Latest commit

 

History

History
81 lines (58 loc) · 3.07 KB

nf-sti-istillimagew-getdeviceinfo.md

File metadata and controls

81 lines (58 loc) · 3.07 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:sti.IStillImageW.GetDeviceInfo
IStillImageW::GetDeviceInfo (sti.h)
The IStillImage::GetDeviceInfo method returns hardware characteristics for a specified still image device.
image\istillimage_getdeviceinfo.htm
image
05/03/2018
IStillImageW::GetDeviceInfo
GetDeviceInfo, GetDeviceInfo method [Imaging Devices], GetDeviceInfo method [Imaging Devices],IStillImageW interface, IStillImageW interface [Imaging Devices],GetDeviceInfo method, IStillImageW.GetDeviceInfo, IStillImageW::GetDeviceInfo, image.istillimage_getdeviceinfo, sti/IStillImageW::GetDeviceInfo, stifnc_a6d46551-9c0a-41f2-a5ed-ca5bc4d1b8c1.xml
sti.h
Sti.h
Desktop
Windows
IStillImageW::GetDeviceInfo
sti/IStillImageW::GetDeviceInfo
APIRef
kbSyntax
COM
sti.h
IStillImageW::GetDeviceInfo

IStillImageW::GetDeviceInfo

-description

The IStillImage::GetDeviceInfo method returns hardware characteristics for a specified still image device.

-parameters

-param pwszDeviceName [in]

Caller-supplied pointer to a string representing an internal device name, obtained by calling IStillImage::GetSTILaunchInformation or IStillImage::GetDeviceList.

-param ppBuffer [out]

Receives a handle to an STI_DEVICE_INFORMATION structure.

-returns

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 IStillImage::GetDeviceInfo method returns an STI_DEVICE_INFORMATION structure for the specified still-image device. Structure contents are typically used for creating user interface displays.

Before calling IStillImage::GetDeviceInfo, clients of the IStillImage COM interface must call IStillImage::StiCreateInstance to obtain an IStillImage interface pointer.

When the caller has finished using the STI_DEVICE_INFORMATION structure referenced by ppBuffer, it must deallocate the buffer by calling LocalFree (described in the Microsoft Windows SDK documentation).

-see-also

IStillImage::GetDeviceList

IStillImageW