put, commande

La commande put définit la zone de l’image source et la fenêtre de destination utilisées pour l’affichage. Les appareils de vidéo numérique et de superposition vidéo reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand, 
  TEXT("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est affecté à l’ouverture de l’appareil.

lpszRegions

Indicateur pour la définition de la zone. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande put et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	destination de destination au cadre de cadre de rectangleau niveau de la source du rectangleau niveau du rectangle	vidéo vidéo dans la fenêtre de la fenêtre rectangledans la fenêtre cliente de la fenêtre rectangleau niveau du rectangle
superposition	destination de destination au cadre de rectangleau niveau du rectangle	source source au rectanglevidéo vidéo au rectangle

Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszRegions et leurs significations.

Valeur	Signification
destination	Sélectionne l’intégralité de la zone cliente de la fenêtre de destination pour afficher les données.
destination au niveau du rectangle	Sélectionne une partie de la zone cliente de la fenêtre de destination utilisée pour afficher l’image. Lorsqu’une zone de la fenêtre d’affichage est spécifiée et que l’appareil prend en charge l’étirement, l’image source est étirée jusqu’au décalage et à l’étendue de destination.
frame	Sélectionne la mémoire tampon d’images entière pour recevoir les images vidéo entrantes.
cadre au rectangle	Sélectionne une partie de la mémoire tampon d’images pour recevoir les images vidéo entrantes.
source	Sélectionne l’image entière à afficher dans la fenêtre de destination.
source au niveau du rectangle	Sélectionne une partie de l’image à afficher dans la fenêtre de destination. Lorsqu’une zone de l’image source est spécifiée et que l’appareil prend en charge l’étirement, l’image source est étirée jusqu’au décalage et à l’étendue de destination.
video	Sélectionne l’intégralité de l’image vidéo entrante à capturer dans la mémoire tampon de trame.
vidéo au niveau du rectangle	Sélectionne une partie de l’image vidéo entrante à capturer dans la mémoire tampon de trame.
window	Restaure la taille de fenêtre initiale sur l’affichage. Cette commande affiche également la fenêtre.
fenêtre au niveau du rectangle	Modifie la taille et l’emplacement de la fenêtre d’affichage. Le rectangle spécifié est relatif à la fenêtre parente de la fenêtre d’affichage (généralement le bureau) si l’indicateur « style enfant » a été utilisé pour la commande open . Pour modifier l’emplacement de la fenêtre sans modifier sa hauteur ou sa largeur, spécifiez zéro pour la hauteur et la largeur.
client de fenêtre	Restaure la zone cliente de la fenêtre.
client de fenêtre au niveau du rectangle	Modifie la taille et l’emplacement de la zone cliente de la fenêtre. Le rectangle spécifié est relatif à la fenêtre parente de la fenêtre cliente. Pour modifier l’emplacement de la fenêtre sans modifier sa hauteur ou sa largeur, spécifiez zéro pour la hauteur et la largeur.

Lorsqu’un indicateur inclut un rectangle, les coordonnées du rectangle sont relatives à l’origine de la fenêtre ou à l’origine de l’image, selon le cas, et sont spécifiées en tant que X1 Y1 X2 Y2. Les coordonnées X1Y1 spécifient le coin supérieur gauche, et les coordonnées X2Y2 spécifient la largeur et la hauteur du rectangle.

lpszFlags

Peut être « attendre », « notifier » ou les deux. Pour les appareils vidéo numériques, « test » peut également être spécifié. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire.

Notes

La commande put définit un ou plusieurs des rectangles suivants lors de l’utilisation d’appareils de superposition vidéo :

• Le rectangle vidéo définit la région de l’image vidéo entrante à capturer.
• Le rectangle d’image définit la région de la mémoire tampon de trame qui reçoit l’image vidéo entrante.
• Le rectangle source définit la région de la mémoire tampon de trame qui est copiée dans le rectangle de destination.
• Le rectangle de destination définit la région de la zone cliente de la fenêtre d’affichage qui reçoit l’image vidéo.

Le rectangle vidéo est lié au rectangle d’image de la même façon que le rectangle source est lié au rectangle de destination. L’étirement peut se produire du rectangle vidéo au rectangle d’image et du rectangle source au rectangle de destination. Tous les appareils ne prennent pas en charge l’étirement, et l’étirement doit être activé (à l’aide de la commande set ).

La commande suivante définit trois régions pour la vidéo, l’image et la source.

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

Les régions de cet exemple sont définies comme suit :

• Une région de 200 pixels par 200 pixels des données vidéo entrantes, à partir d’une origine de 120 pixels à partir du coin supérieur gauche, sera capturée dans la mémoire tampon de l’image.
• Les données vidéo seront placées dans une région de 200 pixels par 200 pixels dans le coin supérieur gauche de la mémoire tampon d’images.
• Les transferts sont effectués à partir de la région de 200 par 200 pixels située dans le coin supérieur gauche de la mémoire tampon de trame vers la fenêtre de destination.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

MCI

Chaînes de commande MCI

open

set