VideoPortCreateSecondaryDisplay-Funktion (video.h)

Artikel
02/07/2025

Die VideoPortCreateSecondaryDisplay-Funktion ermöglicht die Unterstützung der dualen Ansicht, indem ein sekundäres Geräteobjekt für das angegebene Gerät erstellt wird.

Syntax

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

Parameter

[in] HwDeviceExtension

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers. Dies ist die Hardwareerweiterung für das Gerät, das zusätzliche Anzeigegeräteobjekte erstellen möchte.

[in, out] SecondaryDeviceExtension

Zeigen Sie auf die Position, an der die Hardwaregeräteerweiterung für das sekundäre Anzeigegerät gespeichert werden soll.

[in] ulFlag

Ist ein Satz von Attributen für das sekundäre Anzeigegerät. Dieser Parameter ist auf den folgenden Wert beschränkt:

Wert	Bedeutung
VIDEO_DUALVIEW_REMOVABLE	Die sekundäre Ansicht kann entfernt werden.

Rückgabewert

VideoPortCreateSecondaryDisplay gibt NO_ERROR zurück, wenn das sekundäre Anzeigegerät erfolgreich erstellt wurde. Andernfalls gibt diese Funktion einen Fehlercode zurück.

Bemerkungen

In Windows XP und höher wird ein wechselbares logisches Gerät nie zur primären Anzeige.

Beachten Sie, dass in einigen Editionen von Windows XP VideoPortCreateSecondaryDisplay absichtlich fehlschlagen kann, dualview zu aktivieren. In solchen Fällen sollte der Anzeigetreiber im SingleView-Modus verbleiben.

Wenn der Video-Miniporttreiber VideoPortCreateSecondaryDisplayaufruft, muss der Wert des ulFlags--Parameters VIDEO_DUALVIEW_REMOVABLE entsprechen, der in ntddvdeo.hdefiniert ist.

Die Flags VIDEO_DUALVIEW_PRIMARY und VIDEO_DUALVIEW_SECONDARY, die in ntddvdeo.hdefiniert sind, dienen nur der internen Verwendung. Der Video-Miniporttreiber darf diese Flags niemals festlegen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows XP und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	video.h (video.h einschließen)
Library	Videoprt.lib
DLL-	Videoprt.sys
IRQL-	PASSIVE_LEVEL

Freigeben über