VIDEOPARAMETERS structure

  • Article

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

 Tvout.h (include Windows.h)

See also

Device Contexts Overview

Device Context Structures

ChangeDisplaySettingsEx