VideoPortCreateSecondaryDisplay-Funktion (video.h)

  • Artikel

Die VideoPortCreateSecondaryDisplay-Funktion ermöglicht die Unterstützung von Dual-View, 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

Zeiger 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

Zeiger auf den Speicherort der Hardwaregeräteerweiterung für das sekundäre Anzeigegerät.

[in] ulFlag

Ist eine Gruppe 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.

Hinweise

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

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

Wenn der Video minport-Treiber VideoPortCreateSecondaryDisplay aufruft, muss der Wert des ulFlags-Parameters gleich VIDEO_DUALVIEW_REMOVABLE sein, der in ntddvdeo.h definiert ist.

Die flags VIDEO_DUALVIEW_PRIMARY und VIDEO_DUALVIEW_SECONDARY, die in ntddvdeo.h definiert sind, dienen nur zur internen Verwendung. Der Video-Miniporttreiber darf diese Flags niemals festlegen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile video.h (einschließen von Video.h)
Bibliothek Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL