Структура DDVIDEOPORTCONNECT (ksmedia.h)

  • Статья

Структура DDVIDEOPORTCONNECT описывает подключение к аппаратному видеопорту.

Синтаксис

typedef struct _DDVIDEOPORTCONNECT {
  DWORD     dwSize;
  DWORD     dwPortWidth;
  GUID      guidTypeID;
  DWORD     dwFlags;
  ULONG_PTR dwReserved1;
} DDVIDEOPORTCONNECT, *LPDDVIDEOPORTCONNECT;

Члены

dwSize

Задает размер структуры DDVIDEOPORTCONNECT в байтах.

dwPortWidth

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

guidTypeID

Указывает GUID, описывающий характеристики синхронизации аппаратного видеопорта. Предопределены следующие типы портов:

Тип порта Описание
DDVPTYPE_E_HREFH_VREFH Внешние синхронизации, где HREF активен с высоким уровнем активности, а VREF — высоким.
DDVPTYPE_E_HREFH_VREFL Внешние синхронизации, где HREF активен с высоким уровнем активности, а VREF — с низким уровнем активности.
DDVPTYPE_E_HREFL_VREFH Внешние синхронизации, где HREF имеет низкий уровень активности, а VREF — высокий.
DDVPTYPE_E_HREFL_VREFL Внешние синхронизации, где HREF активен с низким уровнем активности, а VREF — с низким уровнем активности.
DDVPTYPE_BROOKTREE Сведения о синхронизации внедряются в поток данных с помощью определения Brooktree.
DDVPTYPE_CCIR656 Сведения о синхронизации внедряются в поток данных в соответствии со спецификацией CCIR656.
DDVPTYPE_PHILIPS Сведения о синхронизации внедряются в поток данных с помощью определения Philips.

dwFlags

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

Flag Значение
DDVPCONNECT_DISCARDSVREFDATA Устройство удаляет все данные, записанные в течение периода VREF, в результате чего эти данные не записываются в буфер кадра. Этот флаг должен устанавливаться только драйвером.
DDVPCONNECT_DOUBLECLOCK При установке драйвером этот флаг указывает, что аппаратный видеопорт способен двойной синхронизации данных. При установке клиентом он указывает, что аппаратный видеопорт должен удвоить частоту данных. Этот флаг действителен только в аппаратном видеопорте с идентификатором guidTypeID , поддерживающим внешнюю синхронизацию.
DDVPCONNECT_HALFLINE При установке драйвером этот флаг указывает, что аппаратный видеопорт поддерживает запись полустрок в буфер кадров, что иногда приводит к неправильному отображению данных. При установке клиентом это означает, что драйвер может записывать половину строк.
DDVPCONNECT_INTERLACED При установке драйвером этот флаг указывает, что аппаратный видеопорт поддерживает сигналы с чередованием. При установке клиентом он указывает, что сигнал переплетается.
DDVPCONNECT_INVERTPOLARITY При установке драйвером этот флаг указывает, что аппаратный видеопорт способен инвертировать полярности поля; то есть рассматривая четные поля как нечетные и наоборот. При установке клиентом он указывает, что аппаратный видеопорт должен инвертировать полярности поля.
DDVPCONNECT_SHAREEVEN В настоящее время эта функция не реализована и должна игнорироваться драйвером.
DDVPCONNECT_SHAREODD В настоящее время эта функция не реализована и должна игнорироваться драйвером.
DDVPCONNECT_VACT При установке драйвером этот флаг указывает, что аппаратный видеопорт может использовать внешний сигнал VACT. При установке клиентом он указывает, что аппаратный видеопорт должен использовать внешний сигнал VACT.

dwReserved1

Зарезервировано для использования системой и должно быть равно нулю.

Комментарии

Подпрограмма обратного вызова DdVideoPortGetConnectInfo драйвера инициализирует структуру DDVIDEOPORTCONNECT для каждого подключения, которое поддерживает аппаратный видеопорт. Клиент может изменить член dwFlags одной из структур DDVIDEOPORTCONNECT драйвера перед вызовом обратного вызова DdVideoPortCanCreate драйвера.

Требования

Требование Значение
Заголовок ksmedia.h (включая Dvp.h)

См. также раздел

DdVideoPortCanCreate

DdVideoPortGetConnectInfo