VideoPortCreateSecondaryDisplay-Funktion (video.h)
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 |