Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The CAMERACAPTURE_VIDEOTYPESenumeration is a Windows Mobile SHCAMERACAPTURE structuremember 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:: nResolutionWidthand SHCAMERACAPTURE:: nResolutionHeightboth equal 0, and a CAMERACAPTURE_VIDEOTYPESvalue of CAMERACAPTURE_VIDEOTYPE_ALLis used, then the user's last selected video resolution is used. For CAMERACAPTURE_VIDEOTYPESvalues of CAMERACAPTURE_VIDEOTYPE_STANDARDand CAMERACAPTURE_VIDEOTYPE_MESSAGING, either SHCAMERACAPTURE:: nResolutionWidthor SHCAMERACAPTURE:: nResolutionHeightmust 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 SHCameraCapturewith a Video Type and video resolution that matches one of the Video Profiles.

  • Video Typespecifies 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 Profilesare registry settings that contain a combination of Video Type, video encoder, video resolution, and a profile name.

When you call the SHCameraCapturefunction, 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_VIDEOTYPESvalue is logically ANDed (&) with the VideoTypevalue 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_INVALIDARGis returned. In this case, you should just call SHCameraCaptureagain, this time with a CAMERACAPTURE_VIDEOTYPESvalue 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.

Copy Code 
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

Header aygshell.h
Library Aygshell.dll
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also