CAMERACAPTURE_VIDEOTYPES

4/8/2010

The CAMERACAPTURE_VIDEOTYPES enumeration is a Windows Mobile SHCAMERACAPTURE structure member that defines the purpose of the video.

Syntax

enum {
  CAMERACAPTURE_VIDEOTYPE_ALL       = 0xFFFF,
  CAMERACAPTURE_VIDEOTYPE_STANDARD  = 1,
  CAMERACAPTURE_VIDEOTYPE_MESSAGING = 2,
} CAMERACAPTURE_VIDEOTYPES;

Enumerators

• CAMERACAPTURE_VIDEOTYPE_ALL
  Produces video clips that match video profiles, using just the video resolution for the match criteria.

  Note

  If SHCAMERACAPTURE::nResolutionWidth and SHCAMERACAPTURE::nResolutionHeight both equal 0, and a CAMERACAPTURE_VIDEOTYPES value of CAMERACAPTURE_VIDEOTYPE_ALL is used, then the user's last selected video resolution is used. For CAMERACAPTURE_VIDEOTYPES values of CAMERACAPTURE_VIDEOTYPE_STANDARD and CAMERACAPTURE_VIDEOTYPE_MESSAGING, either SHCAMERACAPTURE::nResolutionWidth or SHCAMERACAPTURE::nResolutionHeight must not equal 0.

• CAMERACAPTURE_VIDEOTYPE_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.

• CAMERACAPTURE_VIDEOTYPE_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.

Remarks

Multimedia Messaging Service (MMS) applications must be able to capture video that meets criteria specific to multimedia messaging. This includes video format and file size. To accommodate this, it is up to the Windows 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 call SHCameraCapture 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 call the SHCameraCapture function, 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 CAMERACAPTURE_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 E_INVALIDARG is returned. In this case, you should just call SHCameraCapture again, this time with a CAMERACAPTURE_VIDEOTYPES value of CAMERACAPTURE_VIDEOTYPE_ALL (0xFFFF), and no specified video resolution; the first supported video resolution will then be used.

The following example demonstrates a typical video profile registration.

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
...; Setting for the encoder

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.

Requirements

See Also

Reference

Shell Enumerations
SHCameraCapture
SHCAMERACAPTURE (structure)
CAMERACAPTURE_STILLQUALITY
CAMERACAPTURE_VIDEOTYPES

Other Resources

Camera Capture
Camera Capture Graph