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
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
Tvout.h (include Windows.h) |