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 参数的值必须等于 ntddvdeo.h 中定义的 VIDEO_DUALVIEW_REMOVABLE。

ntddvdeo.h 中定义的VIDEO_DUALVIEW_PRIMARY和VIDEO_DUALVIEW_SECONDARY标志仅供内部使用。 视频微型端口驱动程序不得设置这些标志。

要求

要求	值
最低受支持的客户端	在 Windows XP 和更高版本的 Windows 操作系统中可用。
目标平台	桌面
标头	video.h (包括 Video.h)
Library	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL