Структура VIDEOPARAMETERS

Структура VIDEOPARAMETERS содержит информацию для видео соединения.

Синтаксис

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;

Члены структуры

guid

Устанавливает GUID для этой структуры. {02C62061-1097-11d1-920F-00A024DF156E}. Драйверы дисплеев должны проверить GUID в начале структуры перед ее обработкой.

dwOffset

Зарезервирован; должен равняться нулю.

dwCommand

Определяет, извлекать или установить значения, которые обозначены остальными членами этой структуры. Этот член может быть одним из ниже перечисленных значений.

Значение	Предназначение
VP_COMMAND_GET	Получает текущие видео характеристики. Если характеристика не поддерживается, член *dwFlags* - 0.
VP_COMMAND_SET	Устанавливает видеопараметры.

dwFlags

Указывает, какие поля содержат правильные данные. Для VP_COMMAND_GET, это - поля для извлечения данных для VP_COMMAND_SET, это - поля для установки данных. Если характеристика не поддерживается, член dwFlags - 0. Это поле может быть любой комбинацией ниже следующего.

Значение	Поля, содержащие данные
VP_FLAGS_TV_MODE	*dwMode*
VP_FLAGS_TV_STANDARD	*dwTVStandard*
VP_FLAGS_FLICKER	*dwFlickerFilter*
VP_FLAGS_OVERSCAN	*dwOverScanX, dwOverScanY*
VP_FLAGS_MAX_UNSCALED	*dwMaxUnscaledX, dwMaxUnscaledY. Не используйте, если устанавливается VP_COMMAND_SET*.
VP_FLAGS_POSITION	*dwPositionX, dwPositionY*
VP_FLAGS_BRIGHTNESS	*dwBrightness*
VP_FLAGS_CONTRAST	*dwContrast*
VP_FLAGS_COPYPROTECT	*dwCPType, dwCPCommand, dwCPStandard*

dwMode

Устанавливает текущий режим воспроизведения. Этот член правилен и для VP_COMMAND_GET и для VP_COMMAND_SET. Он может быть одним из ниже следующих значений.

Значение	Предназначение
VP_MODE_WIN_GRAPHICS	Описывает установку параметров настройки экрана, которые являются оптимальными для вывода на экран в среде Windows, с фильтром отключения нежелательного мерцания и любого вывода за пределами экрана.
VP_MODE_TV_PLAYBACK	Описывает набор параметров настройки экрана для видео воспроизведения, с фильтром отключения нежелательного мерцания и любого вывода за пределами экрана.

dwTVStandard

Устанавливает телевизионный стандарт. Это поле правильно и для VP_COMMAND_GET и для VP_COMMAND_SET. Оно может быть любым из ниже следующих значений.

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

Устанавливает, какие режимы доступны. Этот член правильный только для VP_COMMAND_GET. Это может быть любая комбинация значений, заданных в члене dwMode.

dwAvailableTVStandard

Определяет телевизионные стандарты, которые являются доступными. Этот член правильный только для VP_COMMAND_GET. Он может быть любой комбинацией значений, заданных в dwTVStandard.

dwFlickerFilter

Устанавливает понижение нежелательного мерцания, предусмотренное аппаратными средствами. Это - значение процента, в десятых долях процента, от 0 до 1 000, где 0 - снижения нежелательного мерцания нет, а 1 000 - максимальное понижение нежелательного мерцания. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwOverScanX

Устанавливает величину бордюра в горизонтальном направлении. Это - значение процента, в десятых долях процента, от 0 до 1 000. Значение 0 - указывает, что нет никакого бордюра, гарантируя, что весь вывод на экран является видимым. Значение 1 000 - максимальный бордюр и обычно заставляет часть изображения за краями экрана отключиться. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwOverScanY

Устанавливает величину бордюра в вертикальном направлении. Это - значение процента, в десятых долях процента, от 0 до 1 000. Значение 0 - указывает, что нет никакого бордюра, гарантируя, что весь вывод на экран является видимым. Значение 1 000 - максимальный бордюр и обычно заставляет часть изображения за краями экрана отключиться. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwMaxUnscaledX

Устанавливает максимальную разрешающую способность по строкам, в пикселях, которая поддерживается, когда видеоизображение не масштабируется. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwMaxUnscaledY

Устанавливает максимальную вертикальную разрешающую способность, в пикселях, которая поддерживается, когда видеоизображение не масштабируется. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwPositionX

Устанавливает горизонтальную настройку центра изображения. Измеряется в пикселях. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwPositionY

Устанавливает вертикальную настройку центра изображения. Измеряется в пикселях. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwBrightness

Настройка в контексте устройства (DC) смещения видеосигнала, чтобы увеличить яркость на телеэкране. Это - значение процента, от 0 до 100, где 0 означает отсутствие настройки, а 100 означает максимальную настройку. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwContrast

Настройка коэффициента усиления видеосигнала, чтобы увеличить интенсивность белого цвета на телеэкране. Это - значение процента, от 0 до 100, где 0 означает отсутствие настройки, а 100 означает максимальную настройку.. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET.

dwCPType

Устанавливает тип защиты от копирования. Это поле правильное и для VP_COMMAND_GET и для VP_COMMAND_SET. Оно может быть одним из ниже следующих значений.

Значение	Предназначение
VP_CP_TYPE_APS_TRIGGER	Доступ только к переключению битов DVD.
VP_CP_TYPE_MACROVISION	Полностью доступны данные Macrovision.

dwCPCommand

Устанавливает команду защиты от копирования. Это поле правильное только для VP_COMMAND_SET. Оно может быть одним из ниже следующих значений.

Значение	Предназначение
VP_CP_CMD_ACTIVATE	Активизирует защиту от копирования.
VP_CP_CMD_CHANGE	Изменяет защиту от копирования.
VP_CP_CMD_DEACTIVATE	Деактивизирует защиту от копирования.

dwCPStandard

Устанавливает телевизионные стандарты, для которых доступны типы защиты от копирования. Это поле правильное только для VP_COMMAND_GET.

dwCPKey

Устанавливает возвращение ключа защиты от копирования, если член dwCPCommand установлен в VP_CP_CMD_ACTIVATE. Вызывающая программа должна установить этот ключ, когда поле dwCPCommand является или VP_CP_CMD_DEACTIVATE или VP_CP_CMD_CHANGE. Если вызывающая программа устанавливает неправильный ключ, драйвер не должен изменять текущие параметры настройки защиты от копирования. Это поле правильное только для VP_COMMAND_SET.

bCP_APSTriggerBits

Определяет переключение битового флажка DVD APS. Это правильно только для VP_COMMAND_SET. В настоящее время, правильны только биты 0 и 1. Член может быть одним из ниже следующих значений.

Значение	Предназначение
0	Нет защиты от копирования.
1, 2, или 3	Macrovision-определяемая аналоговая методика защиты.

bOEMCopyProtection

Устанавливает данные защиты от копирования, определяемые OEM . Максимум 256 символов. Это поле правильное, и для VP_COMMAND_GET, и для VP_COMMAND_SET.

Смотри также

Обзор Контексты устройства, Структуры, используемые контекстами устройства, ChangeDisplaySettingsEx

Размещение и совместимость VIDEOPARAMETERS
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Нет
Windows Me	Да
Windows 98	Да
Windows 95	Нет
Импортируемая библиотека	-
Заголовочный файл
- объявлено в	Tvout.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки