This function returns the value and flags of the selected camera feature.


..................................................................................................................................................................................................................................................................................


Controls and Indicators


          hCamera IN is the camera handle. This value is returned by Initialize.vi and is passed between Pixelink VIs as a reference. 


            uFeatureID IN is the feature ID. The enumerated type definition associated with this control lists the available features. Any cameras will support a subset of these features. See the Programmable Features section of the help file and the Feature definitions in the API manual.


            pParms IN is an array of values for this feature. It is typically ignored on all but a few features where the first element of the array is used to identify which, of a number of similar features, is being requested.


            hCamera OUT has the same value as hCamera IN.


            uFlags OUT contains the feature flags for the requested feature.


            uFeatureId OUT has the same value as uFeatureId IN.


            pParms OUT is an array containing the requested camera feature values.


            uFlags OUT contains the feature flags for the feature.



Details


uFlags OUT can be decoded using the enumerated control FEATURE_FLAGS and the VI GetFeatureFlagsHexValue


The values in pParams OUT array are feature specific.  The size, meaning, order and acceptable values of this array can be found in the camera specific system guide for the camera in question.  Features are camera dependent. Details of which features are supported and how they operate can be found in the camera system guide.  The GetCameraFeatures VI can also be used to identify the presence and range of all features supported by the camera.


It is recommended that the GetFeature VI be called after SetFeature to verify the actual camera settings.  In some cases, where granularity of the control only allows a small set of intermediate values, the camera may apply the closest acceptable value.


GetFeature can read the settings of any custom descriptors that are in use. Note that if all descriptors are in focus at once (rather than just a single descriptor), calling GetFeature will generate an error.


Note: See Error Handling for error input and output information and error codes.