структура KS_VIDEOINFOHEADER2 (ksmedia.h)
Структура KS_VIDEOINFOHEADER2 описывает детали видеопотока, включая параметры боба или ткания, защиту от копирования и пропорции пикселей.
Синтаксис
typedef struct tagKS_VIDEOINFOHEADER2 {
RECT rcSource;
RECT rcTarget;
DWORD dwBitRate;
DWORD dwBitErrorRate;
REFERENCE_TIME AvgTimePerFrame;
DWORD dwInterlaceFlags;
DWORD dwCopyProtectFlags;
DWORD dwPictAspectRatioX;
DWORD dwPictAspectRatioY;
union {
DWORD dwControlFlags;
DWORD dwReserved1;
};
DWORD dwReserved2;
KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER2, *PKS_VIDEOINFOHEADER2;
Члены
rcSource
Задает прямоугольник обрезки, который выбирает часть активного видеосигнала для использования.
rcTarget
Задает прямоугольник, указывающий, какую часть целевого буфера использовать.
dwBitRate
Задает значение, указывающее соответствующую скорость передачи данных видеопотока в битах в секунду.
dwBitErrorRate
Задает значение, указывающее частоту ошибок данных видеопотока в битах в секунду.
AvgTimePerFrame
Задает среднее время на кадр в 100-наносекундных единицах.
dwInterlaceFlags
Указывает сведения о переплетении. Неопределенные флаги должны быть равны нулю, иначе подключение может быть отклонено. Для этого элемента можно задать одно или несколько (логических ИЛИ) значений, определенных в ksmedia.h:
| Flag | Описание |
|---|---|
| KS_INTERLACE_IsInterlaced | Указывает поток с чередованием. Если значение 0, то другие KS_INTERLACE_Xxx биты не имеют значения. |
| KS_INTERLACE_1FieldPerSample | Указывает одно поле на выборку носителя. Если значение равно нулю, указывает два поля на выборку носителя. |
| KS_INTERLACE_Field1First | Указывает, что поле 1 является первым. Если значение равно нулю, означает, что поле 2 является первым. Первое поле в PAL — Поле 1, а в NTSC — Поле 2. |
| KS_INTERLACE_UNUSED | Не используется |
| KS_INTERLACE_FieldPatternMask | Указывает биты, используемые для указания шаблона поля. |
| KS_INTERLACE_FieldPatField1Only | Указывает, что поток никогда не содержит поле 2. |
| KS_INTERLACE_FieldPatField2Only | Указывает, что поток никогда не содержит поле 1. |
| KS_INTERLACE_FieldPatBothRegular | Указывает, что для каждого поля 1 будет указано поле 2. |
| KS_INTERLACE_FieldPatBothIrregular | Указывает случайный шаблон полей 1 и 2. |
| KS_INTERLACE_DisplayModeMask | Недопустимо для захвата видео. |
| KS_INTERLACE_DisplayModeBobOnly | Недопустимо для захвата видео. |
| KS_INTERLACE_DisplayModeWeaveOnly | Недопустимо для захвата видео. |
| KS_INTERLACE_DisplayModeBobOrWeave | Недопустимо для захвата видео. |
dwCopyProtectFlags
Задает значение KSCOPYPROTECTRestrictDuplication (0x00000001), указывающее, следует ли ограничить дублирование потока. Если значение не определено, укажите ноль, иначе подключение будет отклонено.
dwPictAspectRatioX
Задает измерение x пропорций изображения (например, 16 для дисплея 16 × 9). Значение выражается в дюймах за дюймами, а не в пикселях за пикселями.
dwPictAspectRatioY
Задает измерение y пропорций изображения (например, 9 для отображения 16 × 9). Значение выражается в дюймах за дюймами, а не в пикселях за пикселями.
dwControlFlags
В операционных системах до Windows Vista этот член назывался dwReserved1 и должен был иметь нулевое значение. В Windows Vista dwReserved1 был объединён в объединение с новым членом с именем dwControlFlags. При использовании dwControlFlags содержит побитовое ИЛИ флагов в следующей таблице.
| Значение | Описание |
|---|---|
| AMCONTROL_USED | Указывает, что используются флаги dwControlFlags . |
| AMCONTROL_PAD_TO_4x3 | Изображение должно быть заполнено и отображаться в области 4 x 3. |
| AMCONTROL_PAD_TO_16x9 | Изображение должно быть заполнено и отображаться в области 16 x 9. |
| AMCONTROL_COLORINFO_PRESENT | Дополнительные сведения о цвете содержатся в верхних 24 битах поля dwControlFlags . |
Флаг AMCONTROL_USED обеспечивает обратную совместимость со старыми фильтрами. Если флаг AMCONTROL_USED не задан, остальные биты в этом поле следует игнорировать. Если фильтр использует другие флаги, он должен задать флаг AMCONTROL_USED.
Два флага AMCONTROL_PAD_xxx используются декодировщиками для определения пропорций выходного прямоугольника.
Если установлен флаг AMCONTROL_COLORINFO_PRESENT, это означает, что верхние 24 бита поля dwControlFlags обрабатываются как структура DXVA_ExtendedFormat .
Дополнительные сведения о dwControlFlags см. в разделе Примечания далее в этом разделе.
dwReserved1
Этот элемент предназначен для обеспечения обратной совместимости. Дополнительные сведения см. в разделе dwControlFlags .
dwReserved2
Зарезервировано для системного использования. Необходимо задать нулевое значение, иначе подключение будет отклонено.
bmiHeader
Указывает структуру KS_BITMAPINFOHEADER , содержащую сведения о цвете и измерении для растрового изображения видео.
Комментарии
Чтобы описать видеопоток без параметров bob или плетения, используйте KS_VIDEOINFOHEADER.
Структура KS_VIDEOINFOHEADER2 идентична структуре DirectShow VIDEOINFOHEADER2 .
Мини-накопители захвата, создающие поля видео (а не кадры), должны использовать структуру KS_DATARANGE_VIDEO2 , которая содержит структуру KS_VIDEOINFOHEADER2.
Исходный фильтр может запросить, чтобы фильтр приемника принимает только часть видео, предоставляя значения, которые фактически определяют прямоугольник обрезки в элементе rcSource . Однако если фильтр приемника не проверка для прямоугольника обрезки при подключении, фильтр приемника просто отрисовывает все видео, фактически игнорируя любые сведения об вырезке, передаваемые из исходного фильтра в фильтр приемника.
В идеале фильтр приемника проверяет rcSource и, если фильтр приемника не поддерживает извлечение изображения, а прямоугольник не пуст, он отклоняет подключение. Фильтр должен использовать функцию Win32 SetRectEmpty, чтобы сбросить прямоугольник до всех нулей (и задать isRectEmpty для последующего проверка прямоугольника).
Член rcTarget указывает целевой прямоугольник для видео. Большинство исходных фильтров устанавливают для этого элемента все нули. Подчиненный фильтр может запросить размещение видео в определенной области буферов, которые он предоставляет. В этом случае он вызывает функцию Win32 QueryAccept с непустой целью.
Если флаг AMCONTROL_COLORINFO_PRESENT задан в элементе dwControlFlags , можно привести значение dwControlFlags к DXVA_ExtendedFormat структуре для доступа к расширенным сведениям о цвете. Дополнительные сведения см. в разделе VIDEOINFOHEADER2.
Требования
| Требование | Значение |
|---|---|
| Заголовок | ksmedia.h (включая Ksmedia.h) |