VideoPortCreateSecondaryDisplay - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// video.h
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCreateSecondaryDisplay(
[in] IN PVOID HwDeviceExtension,
[in, out] IN OUT PVOID *SecondaryDeviceExtension,
[in] IN ULONG ulFlag
);
View the official Windows Driver Kit DDI referenceNo description available.
The VideoPortCreateSecondaryDisplay function enables dual-view support by creating a secondary device object for the given device.
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:
| Value | Meaning |
|---|---|
| VIDEO_DUALVIEW_REMOVABLE | The secondary view can be removed. |
VideoPortCreateSecondaryDisplay returns NO_ERROR if the secondary display device was successfully created. Otherwise, this function returns an error code.
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 miniport 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.