This function creates a descriptor on the host computer or on the camera.



Also review the following topics:


  • Advanced CSRs


  • Creating and using Custom Descriptors


  • Descriptors


  • Frame Features in Descriptors

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


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.


        uUpdateMode IN is the initial update mode of the descriptor being created.


        hCamera OUT has the same value as hCamera IN.


        hDescriptorHandle OUT is a handle to the new Descriptor. Pass the value to UpdateDescriptor or RemoveDescriptor.



Equivalent API Function: PxLCreateDescriptor


Details


The new descriptor is created using the current camera settings and is applicable only to the camera for which it was created.


If uUpdateMode IN is set to PXL_UPDATE_HOST, then the descriptor is created (cached) on the host computer only. It will not be applied to the camera until UpdateDescriptor is called with the update mode set to PXL_UPDATE_CAMERA.


If uUpdateMode IN is set to PXL_UPDATE_CAMERA, then the descriptor is cached on the host computer and applied immediately to the camera.


See UpdateDescriptor for a more detailed description of the update modes.


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