VIDEOPARAMETERS structure

The VIDEOPARAMETERS structure contains information for a video connection.

Syntax

typedef struct _VIDEOPARAMETERS {
  GUID  guid;
  ULONG dwOffset;
  ULONG dwCommand;
  ULONG dwFlags;
  ULONG dwMode;
  ULONG dwTVStandard;
  ULONG dwAvailableModes;
  ULONG dwAvailableTVStandard;
  ULONG dwFlickerFilter;
  ULONG dwOverScanX;
  ULONG dwOverScanY;
  ULONG dwMaxUnscaledX;
  ULONG dwMaxUnscaledY;
  ULONG dwPositionX;
  ULONG dwPositionY;
  ULONG dwBrightness;
  ULONG dwContrast;
  ULONG dwCPType;
  ULONG dwCPCommand;
  ULONG dwCPStandard;
  ULONG dwCPKey;
  ULONG bCP_APSTriggerBits;
  UCHAR bOEMCopyProtection[256];
} VIDOEPARAMETERS, *PVIDEOPARAMETERS;

Members

• guid
  The GUID for this structure. {02C62061-1097-11d1-920F-00A024DF156E}. Display drivers should verify the GUID at the start of the structure before processing the structure.

• dwOffset
  Reserved; must be zero.

• dwCommand
  Specifies whether to retrieve or set the values that are indicated by the other members of this structure. This member can be one of the following values.

  Value	Meaning
  VP_COMMAND_GET	Gets current video capabilities. If capability is not supported, dwFlags is 0.
  VP_COMMAND_SET	Sets video parameters.

   

• dwFlags
  Indicates which fields contain valid data. For VP_COMMAND_GET, this should be zero. For VP_COMMAND_SET, these are the fields to set. It can be any combination of the following.

  Value	Fields containing data
  VP_FLAGS_TV_MODE	dwMode (for VP_COMMAND_GET and VP_COMMAND_SET) and dwAvailableModes (for VP_COMMAND_GET).
  VP_FLAGS_TV_STANDARD	dwTVStandard (for VP_COMMAND_GET and VP_COMMAND_SET) and dwAvailableTVStandard (for VP_COMMAND_GET).
  VP_FLAGS_FLICKER	dwFlickerFilter (for VP_COMMAND_GET and VP_COMMAND_SET).
  VP_FLAGS_OVERSCAN	dwOverScanX, dwOverScanY (for VP_COMMAND_GET and VP_COMMAND_SET).
  VP_FLAGS_MAX_UNSCALED	dwMaxUnscaledX, dwMaxUnscaledY (for VP_COMMAND_GET).
  VP_FLAGS_POSITION	dwPositionX, dwPositionY (for VP_COMMAND_GET and VP_COMMAND_SET).
  VP_FLAGS_BRIGHTNESS	dwBrightness (for VP_COMMAND_GET and VP_COMMAND_SET).
  VP_FLAGS_CONTRAST	dwContrast (for VP_COMMAND_GET and VP_COMMAND_SET).
  VP_FLAGS_COPYPROTECT	dwCPType (for VP_COMMAND_GET and VP_COMMAND_SET), dwCPCommand (for VP_COMMAND_SET), dwCPStandard (for VP_COMMAND_GET), dwCPKey (for VP_COMMAND_SET), bCP_APSTriggerBits, bOEMCopyProtection (for VP_COMMAND_GET and VP_COMMAND_SET).

   

• dwMode
  The current playback mode. This member is valid for both VP_COMMAND_GET and VP_COMMAND_SET. It can be one of the following.

  Value	Meaning
  VP_MODE_WIN_GRAPHICS	Describes a set of display settings that are optimal for Windows display, with the flicker filter on and any overscan display off.
  VP_MODE_TV_PLAYBACK	Describes a set of display settings for video playback, with the flicker filter off and the overscan display on.

   

• dwTVStandard
  The TV standard. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET. It can be any one of the following.

  • VP_TV_STANDARD_NTSC_433
  • VP_TV_STANDARD_NTSC_M
  • VP_TV_STANDARD_NTSC_M_J
  • VP_TV_STANDARD_PAL_60
  • VP_TV_STANDARD_PAL_B
  • VP_TV_STANDARD_PAL_D
  • VP_TV_STANDARD_PAL_G
  • VP_TV_STANDARD_PAL_H
  • VP_TV_STANDARD_PAL_I
  • VP_TV_STANDARD_PAL_M
  • VP_TV_STANDARD_PAL_N
  • VP_TV_STANDARD_SECAM_B
  • VP_TV_STANDARD_SECAM_D
  • VP_TV_STANDARD_SECAM_G
  • VP_TV_STANDARD_SECAM_H
  • VP_TV_STANDARD_SECAM_K
  • VP_TV_STANDARD_SECAM_K1
  • VP_TV_STANDARD_SECAM_L
  • VP_TV_STANDARD_SECAM_L1
  • VP_TV_STANDARD_WIN_VGA

• dwAvailableModes
  Specifies which modes are available. This is valid only for VP_COMMAND_GET. It can be any combination of the values specified in dwMode.

• dwAvailableTVStandard
  The TV standards that are available. This is valid only for VP_COMMAND_GET. It can be any combination of the values specified in dwTVStandard.

• dwFlickerFilter
  The flicker reduction provided by the hardware. This is a percentage value in tenths of a percent, from 0 to 1,000, where 0 is no flicker reduction and 1,000 is maximum flicker reduction. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

• dwOverScanX
  The amount of overscan in the horizontal direction. This is a percentage value in tenths of a percent, from 0 to 1,000. A value of 0 indicates no overscan, ensuring that the entire display is visible. A value of 1,000 is maximum overscan and typically causes some of the image to be off the edge of the screen. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

• dwOverScanY
  The amount of overscan in the vertical direction. This is a percentage value in tenths of a percent, from 0 to 1,000. A value of 0 indicates no overscan, ensuring that the entire display is visible. A value of 1,000 is maximum overscan and typically causes some of the image to be off the edge of the screen. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

• dwMaxUnscaledX
  The maximum horizontal resolution, in pixels, that is supported when the video is not scaled. This field is valid for both VP_COMMAND_GET.

• dwMaxUnscaledY
  The maximum vertical resolution, in pixels, that is supported when the video is not scaled. This field is valid for both VP_COMMAND_GET.

• dwPositionX
  The horizontal adjustment to the center of the image. Units are in pixels. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

• dwPositionY
  The vertical adjustment to the center of the image. Units are in scan lines. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

• dwBrightness
  Adjustment to the DC offset of the video signal to increase brightness on the television. It is a percentage value, 0 to 100, where 0 means no adjustment and 100 means maximum adjustment. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

• dwContrast
  Adjustment to the gain of the video signal to increase the intensity of whiteness on the television. It is a percentage value, 0 to 100, where 0 means no adjustment and 100 means maximum adjustment. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

• dwCPType
  The copy protection type. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET. It can be one of the following.

  Value	Meaning
  VP_CP_TYPE_APS_TRIGGER	Only DVD trigger bits available.
  VP_CP_TYPE_MACROVISION	Full Macrovision data is available.

   

• dwCPCommand
  The copy protection command. This field is only valid for VP_COMMAND_SET. It can be one of the following.

  Value	Meaning
  VP_CP_CMD_ACTIVATE	Activate copy protection.
  VP_CP_CMD_CHANGE	Change copy protection.
  VP_CP_CMD_DEACTIVATE	Deactivate copy protection.

   

• dwCPStandard
  Specifies TV standards for which copy protection types are available. This field is valid only for VP_COMMAND_GET.

• dwCPKey
  The copy protection key returned if dwCPCommand is set to VP_CP_CMD_ACTIVATE. The caller must set this key when the dwCPCommand field is either VP_CP_CMD_DEACTIVATE or VP_CP_CMD_CHANGE. If the caller sets an incorrect key, the driver must not change the current copy protection settings. This field is valid only for VP_COMMAND_SET.

• bCP_APSTriggerBits
  The DVD APS trigger bit flag. This is valid only for VP_COMMAND_SET. Currently, only bits 0 and 1 are valid. It can be one of the following.

  Value	Meaning
  0	No copy protection.
  1, 2, or 3	Macrovision-defined analog protection methods.

   

• bOEMCopyProtection
  The OEM-specific copy protection data. Maximum of 256 characters. This field is valid for both VP_COMMAND_GET and VP_COMMAND_SET.

Requirements

See also

Device Contexts Overview

Device Context Structures

ChangeDisplaySettingsEx