IsVideoModeAvailable

Description

Checks the availability of the specified DCAM (IIDC-1394) video mode for the currently selected camera.


Syntax

[VB]
Value=objActiveDcam.IsVideoModeAvailable ( Format, Mode, Code ) 

[C/C++]
HRESULT IsVideoModeAvailable( short iFormat, short iMode, short iCode );


Data Types [VB]

Format: Integer
Mode: Integer
Code: Integer
Return value: Boolean

Parameters [C/C++]

Format [in]

Integer in the range of 0-7 specifying the V_FORMAT_INQ value of the video mode.

Mode [in]

Integer in the range of 0-7 specifying the V_MODE_INQ value of the video mode.

Code [in]

If Format < 7: Integer in the range of 0-7 specifying the V_RATE_INQ value of the video mode.

If Format = 7: Integer in the range of 0-255 specifying the COLOR_CODING_INQ value of the video mode.

   

Return Values

S_OK

Success

E_FAIL

Failure

Example

This fragment of VB code fills a 3D array with an information about DCAM formats, modes and rates available for the currently selected camera:

Dim M(7, 7, 7)
For i = 0 To 7
 For j = 0 To 7
  For k = 0 To 7
   M(i, j, k) = ActiveDcam1.IsVideoModeAvailable(i, j, k)
  Next
 Next
Next
      
Remarks

For more information on DCAM video modes refer to "IIDC 1394-based Digital Camera Specification, Version 1.31" published by the 1394 Trade Association.