commande capture

La commande capture copie le contenu de la mémoire tampon de frame et le stocke dans le fichier spécifié. Les périphériques vidéo numériques reconnaissent cette commande.

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

_stprintf_s(
  lpszCommand, 
  TEXT("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszCapture

Un ou plusieurs des indicateurs suivants :

Valeur Signification
comme chemin d’accès Spécifie le chemin d’accès et le nom de fichier de destination de l’image capturée. Cet indicateur est obligatoire.
au niveau du rectangle Spécifie la zone rectangulaire dans la mémoire tampon de trame que l’appareil rogne et enregistre sur le disque. En cas d’omission, la zone rognée est définie par défaut sur le rectangle spécifié ou par défaut sur une commande put « source » précédente pour cette instance d’appareil.

lpszFlags

Peut être « Wait », « Notify », « test » ou une combinaison de ceux-ci. 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 une erreur.

Remarques

Cette commande peut échouer si l’appareil est en train de visionner des vidéos animées ou d’exécuter d’autres opérations gourmandes en ressources. Si la mémoire tampon de trame est mise à jour en temps réel, la mise à jour s’interrompt momentanément afin qu’une image complète soit capturée. Si l’appareil interrompt la mise à jour, il peut y avoir un effet visuel ou audible. Si le format de fichier, l’algorithme de compression et les niveaux de qualité n’ont pas été définis, leurs valeurs par défaut sont utilisées.

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

posé