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]

Voir aussi

MCI

Chaînes de commande MCI

capability

Dégeler