VideoPortCreateSecondaryDisplay function

The VideoPortCreateSecondaryDisplay function enables dual-view support by creating a secondary device object for the given device.

Syntax


VP_STATUS VideoPortCreateSecondaryDisplay(
  _In_    PVOID HwDeviceExtension,
  _Inout_ PVOID *SecondaryDeviceExtension,
  _In_    ULONG ulFlag
);

Parameters

HwDeviceExtension [in]

Pointer to the miniport driver's device extension. This is the hardware extension for the device that wants to create additional display device objects.

SecondaryDeviceExtension [in, out]

Pointer to the location in which to store the hardware device extension for the secondary display device.

ulFlag [in]

Is a set of attributes for the secondary display device. This parameter is restricted to the following value:

ValueMeaning

VIDEO_DUALVIEW_REMOVABLE

The secondary view can be removed.

 

Return value

VideoPortCreateSecondaryDisplay returns NO_ERROR if the secondary display device was successfully created. Otherwise, this function returns an error code.

Remarks

In Windows XP and later, a removable logical device will never become the primary display.

Note that on some editions of Windows XP, VideoPortCreateSecondaryDisplay can deliberately fail to enable Dualview. In such cases, the display driver should remain in SingleView mode.

When the video minport driver calls VideoPortCreateSecondaryDisplay, the value of the ulFlags parameter must be equal to VIDEO_DUALVIEW_REMOVABLE, which is defined in ntddvdeo.h.

The flags VIDEO_DUALVIEW_PRIMARY and VIDEO_DUALVIEW_SECONDARY, which are defined in ntddvdeo.h, are for internal use only. The video miniport driver must never set these flags.

Requirements

Target platform

Version

Available in Windows XP and later versions of the Windows operating systems.

Header

Video.h (include Video.h)

Library

Videoprt.lib

DLL

Videoprt.sys

IRQL

PASSIVE_LEVEL

 

 

Send comments about this topic to Microsoft

Show: