commande freeze
La commande freeze fige l’entrée vidéo ou la sortie vidéo sur un magnétoscope ou désactive l’acquisition vidéo dans la mémoire tampon d’image. Les appareils de vidéo numérique, de superposition vidéo et de magnétoscope reconnaissent cette commande.
Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.
_stprintf_s(
lpszCommand,
TEXT("freeze %s %s %s"),
lpszDeviceID,
lpszFreezeFlags,
lpszFlags
);
Paramètres
-
lpszDeviceID
-
Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.
-
lpszFreezeFlags
-
Indicateur qui identifie les éléments à figer. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande freeze et les indicateurs utilisés par chaque type.
Valeur Signification Signification digitalvideo au rectangle Extérieur superposition au rectangle Magnétoscope - field
- frame
- entrée
- sortie
Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszFreezeFlags et leurs significations.
Valeur Signification au rectangle Spécifie la région qui sera figée. Pour les appareils de superposition vidéo, l’acquisition vidéo sera désactivée dans cette région. Pour les appareils vidéo numériques, les pixels du rectangle auront leur bit de masque de verrouillage activé (sauf si l’indicateur « extérieur » est spécifié). Le rectangle est relatif à l’origine de la mémoire tampon vidéo et est spécifié sous la forme X1 Y1 X2 Y2. Les coordonnées X1 Y1 spécifient le coin supérieur gauche du rectangle, et les coordonnées X2 Y2 spécifient la largeur et la hauteur. field Fige le premier champ. Field est supposé par défaut (si ni frame ni champ n’est spécifié). frame Fige l’ensemble du cadre, affichant les deux champs. entrée Fige l’image actuelle de l’image d’entrée, qu’elle soit en pause ou en cours d’exécution. sortie Fige l’image actuelle de la sortie du magnétoscope. Si le magnétoscope est en cours de lecture lorsque le gel est émis, l’image actuelle est figée et le magnétoscope est suspendu. Si le magnétoscope est suspendu lors de l’émission de cette commande, l’image actuelle est figée. L’image figée reste sur l’appareil de sortie jusqu’à ce qu’une commande de dégel soit émise. Si ni « input » ni « output » n’est spécifié, « output » est supposé. Extérieur Indique que la zone en dehors de la région spécifiée à l’aide de l’indicateur « at » est figée. -
lpszFlags
-
Peut être « attendre », « notifier » ou les deux. Pour les appareils de vidéo numérique et de magnétoscope, « test » peut également être spécifié. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.
Valeur renvoyée
Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.
Notes
Lorsqu’elle est utilisée avec des appareils magnétoscopes, cette commande est destinée aux cartes de capture d’images.
Pour spécifier des régions d’acquisition irrégulières avec l’indicateur « at », utilisez une série de commandes de gel et de dégel . Certains appareils de superposition vidéo limitent la complexité de la région d’acquisition.
Cette commande est prise en charge uniquement si un appel à la commande de capacité avec l’indicateur « peut geler » renvoie TRUE.
Exemples
La commande suivante désactive l’acquisition vidéo dans un carré de 100 pixels dans le coin supérieur gauche de la mémoire tampon vidéo.
freeze vboard at 0 0 100 100
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] |