Функция VideoPortCreateSecondaryDisplay (video.h)

Функция VideoPortCreateSecondaryDisplay обеспечивает поддержку двойного просмотра, создавая дополнительный объект устройства для данного устройства.

Синтаксис

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCreateSecondaryDisplay(
  [in]      IN PVOID     HwDeviceExtension,
  [in, out] IN OUT PVOID *SecondaryDeviceExtension,
  [in]      IN ULONG     ulFlag
);

Параметры

[in] HwDeviceExtension

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

[in, out] SecondaryDeviceExtension

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

[in] ulFlag

Набор атрибутов для дополнительного устройства отображения. Этот параметр ограничен следующим значением:

Значение Значение
VIDEO_DUALVIEW_REMOVABLE Дополнительное представление можно удалить.

Возвращаемое значение

VideoPortCreateSecondaryDisplay возвращает NO_ERROR, если дополнительное устройство отображения было успешно создано. В противном случае эта функция возвращает код ошибки.

Комментарии

В Windows XP и более поздних версиях съемное логическое устройство никогда не станет основным дисплеем.

Обратите внимание, что в некоторых выпусках Windows XP VideoPortCreateSecondaryDisplay может намеренно не включить Dualview. В таких случаях драйвер дисплея должен оставаться в режиме SingleView.

Когда драйвер minport видео вызывает VideoPortCreateSecondaryDisplay, значение параметра ulFlags должно быть равно VIDEO_DUALVIEW_REMOVABLE, которое определено в ntddvdeo.h.

Флаги VIDEO_DUALVIEW_PRIMARY и VIDEO_DUALVIEW_SECONDARY, определенные в ntddvdeo.h, предназначены только для внутреннего использования. Драйвер видео минипорта никогда не должен устанавливать эти флаги.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows XP и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL