IsVideoModeAvailable
Top  Previous  Next

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.