Fonction VideoPortCreateSecondaryDisplay (video.h)

Article
02/26/2024

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

Partager via