CameraCaptureVideoTypes Enumeration

3/29/2010

The CameraCaptureVideoTypes enumeration defines the purpose of the video.

Namespace: Microsoft.WindowsMobile.Forms
Assembly: Microsoft.WindowsMobile.Forms (in microsoft.windowsmobile.forms.dll)

Syntax

public enum CameraCaptureVideoTypes
'Declaration
Public Enumeration CameraCaptureVideoTypes

Members

Member name Description
All Only the resolution is used when matching video profiles. If resolution width and height both equal 0, and a CameraCaptureVideoTypes value of All is used, then the user's last selected resolution is used. Value = 0xFFFF.
Messaging Produces video clips used for Multimedia Messaging Service (MMS) video messaging, which require a video encoder that conforms to the 3rd Generation Partnership Project (3GPP) specification. For a CameraCaptureVideoTypes value of Messaging, neither resolution width nor height can equal 0. Value = 2.
Standard Produces high-quality video clips used for home movies and e-mail video messaging, using a video encoder such as the Windows Media encoder. For a CameraCaptureVideoTypes value of Standard, neither resolution width nor height can equal 0. Value = 1.

Remarks

Multimedia Messaging Service (MMS) applications must be able to capture video that meets criteria specific to multimedia messaging. To accommodate this, it is up to the mobile device Original Equipment Manufacturer (OEM) to register Video Profiles for each of the Video Types (All, Standard, and Messaging). To be compliant, you just need to create a CameraCaptureDialog object with a Video Type and video resolution that matches one of the Video Profiles.

  • Video Type specifies whether the video should be recorded in a format that is compatible with video messaging (usually encoded in either MPEG4 format or H.263 format), or for use in home videos and e-mail messaging (usually encoded in Windows Media Video (WMV) format).

  • Video Profiles are registry settings that contain a combination of Video Type, video encoder, video resolution, and a profile name.

When you create a CameraCaptureDialog object, the Video Type and video resolution that you specify are matched to a corresponding Video Profile to determine which Video Profile is used to initialize video capture mode. Your VideoTypes value is logically ANDed (&) with the VideoType value in each registered profile (e.g., "VideoType:DWORD = 0x0002" for messaging). Of those that produce a 1, the video resolutions are then compared. If a matching Video Profile is found, then it is used to initialize video capture mode. If one cannot be found, then an System.ArgumentException exception is raised. In this case, you should just create a CameraCaptureDialog object again, this time with a VideoTypes value of All (0xFFFF), and no specified video resolution; the first supported video resolution will then be used.

HKEY_LOCAL_MACHINE\Software\Microsoft\Pictures\Camera\OEM\VideoProfile\1
ItemString:String = "MMS (174x144)"
VideoType:DWORD = 0x0002 ; For messaging
Width:DWORD = 176
Height:DWORD = 144

You can estimate the video file size that meets the time-limit restriction by specifying a particular video resolution.

Each Video Profile is listed as an option for the user in Pictures & Video > Menu > Quality.

See Also

Reference

Microsoft.WindowsMobile.Forms Namespace