Funzione VideoPortCreateSecondaryDisplay (video.h)

La funzione VideoPortCreateSecondaryDisplay consente il supporto della doppia visualizzazione creando un oggetto dispositivo secondario per il dispositivo specificato.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport. Si tratta dell'estensione hardware per il dispositivo che vuole creare oggetti dispositivo di visualizzazione aggiuntivi.

[in, out] SecondaryDeviceExtension

Puntatore alla posizione in cui archiviare l'estensione del dispositivo hardware per il dispositivo di visualizzazione secondario.

[in] ulFlag

È un set di attributi per il dispositivo di visualizzazione secondario. Questo parametro è limitato al valore seguente:

Valore restituito

VideoPortCreateSecondaryDisplay restituisce NO_ERROR se il dispositivo di visualizzazione secondario è stato creato correttamente. In caso contrario, questa funzione restituisce un codice di errore.

Commenti

In Windows XP e versioni successive, un dispositivo logico rimovibile non diventerà mai il display primario.

Si noti che in alcune edizioni di Windows XP, VideoPortCreateSecondaryDisplay può non riuscire intenzionalmente a abilitare Dualview. In questi casi, il driver di visualizzazione deve rimanere in modalità SingleView.

Quando il driver minport video chiama VideoPortCreateSecondaryDisplay, il valore del parametro ulFlags deve essere uguale a VIDEO_DUALVIEW_REMOVABLE, definito in ntd mdfeo.h.

I flag VIDEO_DUALVIEW_PRIMARY e VIDEO_DUALVIEW_SECONDARY, definiti in ntdmakeo.h, sono solo per uso interno. Il driver miniport video non deve mai impostare questi flag.

Requisiti