Fonction VideoPortCreateSecondaryDisplay (video.h)

  • Article

La fonction VideoPortCreateSecondaryDisplay permet la prise en charge de la double vue en créant un objet d’appareil secondaire pour l’appareil donné.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport. Il s’agit de l’extension matérielle de l’appareil qui souhaite créer des objets d’appareil d’affichage supplémentaires.

[in, out] SecondaryDeviceExtension

Pointeur vers l’emplacement dans lequel stocker l’extension de périphérique matériel pour le périphérique d’affichage secondaire.

[in] ulFlag

Ensemble d’attributs pour le périphérique d’affichage secondaire. Ce paramètre est limité à la valeur suivante :

Valeur Signification
VIDEO_DUALVIEW_REMOVABLE La vue secondaire peut être supprimée.

Valeur retournée

VideoPortCreateSecondaryDisplay retourne NO_ERROR si le périphérique d’affichage secondaire a été créé avec succès. Sinon, cette fonction retourne un code d’erreur.

Remarques

Dans Windows XP et versions ultérieures, un appareil logique amovible ne deviendra jamais l’affichage principal.

Notez que sur certaines éditions de Windows XP, VideoPortCreateSecondaryDisplay peut délibérément échouer à activer Dualview. Dans ce cas, le pilote d’affichage doit rester en mode SingleView.

Lorsque le pilote de minport vidéo appelle VideoPortCreateSecondaryDisplay, la valeur du paramètre ulFlags doit être égale à VIDEO_DUALVIEW_REMOVABLE, qui est définie dans ntddvdeo.h.

Les indicateurs VIDEO_DUALVIEW_PRIMARY et VIDEO_DUALVIEW_SECONDARY, définis dans ntddvdeo.h, sont à usage interne uniquement. Le pilote de miniport vidéo ne doit jamais définir ces indicateurs.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows XP et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête video.h (inclure Video.h)
Bibliothèque Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL