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

Статья
02/07/2025

Функция 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.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows XP и более поздних версиях операционных систем Windows.
целевая платформа	Настольный
заголовка	video.h (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Поделиться через