Export (0) Print
Expand All

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.

ValueMeaning
VP_COMMAND_GETGets current video capabilities. If capability is not supported, dwFlags is 0.
VP_COMMAND_SETSets 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.

ValueFields containing data
VP_FLAGS_TV_MODEdwMode (for VP_COMMAND_GET and VP_COMMAND_SET) and dwAvailableModes (for VP_COMMAND_GET).
VP_FLAGS_TV_STANDARDdwTVStandard (for VP_COMMAND_GET and VP_COMMAND_SET) and dwAvailableTVStandard (for VP_COMMAND_GET).
VP_FLAGS_FLICKERdwFlickerFilter (for VP_COMMAND_GET and VP_COMMAND_SET).
VP_FLAGS_OVERSCANdwOverScanX, dwOverScanY (for VP_COMMAND_GET and VP_COMMAND_SET).
VP_FLAGS_MAX_UNSCALEDdwMaxUnscaledX, dwMaxUnscaledY (for VP_COMMAND_GET).
VP_FLAGS_POSITIONdwPositionX, dwPositionY (for VP_COMMAND_GET and VP_COMMAND_SET).
VP_FLAGS_BRIGHTNESSdwBrightness (for VP_COMMAND_GET and VP_COMMAND_SET).
VP_FLAGS_CONTRASTdwContrast (for VP_COMMAND_GET and VP_COMMAND_SET).
VP_FLAGS_COPYPROTECTdwCPType (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.

ValueMeaning
VP_MODE_WIN_GRAPHICSDescribes a set of display settings that are optimal for Windows display, with the flicker filter on and any overscan display off.
VP_MODE_TV_PLAYBACKDescribes 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.

ValueMeaning
VP_CP_TYPE_APS_TRIGGEROnly DVD trigger bits available.
VP_CP_TYPE_MACROVISIONFull 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.

ValueMeaning
VP_CP_CMD_ACTIVATEActivate copy protection.
VP_CP_CMD_CHANGEChange copy protection.
VP_CP_CMD_DEACTIVATEDeactivate 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.

ValueMeaning
0No copy protection.
1, 2, or 3Macrovision-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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft