Partager via


commande capture

La commande capture copie le contenu de la mémoire tampon de trame et le stocke dans le fichier spécifié. Les appareils 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
en tant que chemin d’accès Spécifie le chemin d’accès de destination et le nom du fichier de l’image capturée. Cet indicateur est obligatoire.
au rectangle Spécifie la région rectangulaire dans la mémoire tampon de trame que l’appareil récolte et enregistre sur le disque. En cas d’omission, la région rognée correspond par défaut au rectangle spécifié ou défini par défaut sur une commande « source » précédente pour cet appareil instance.

lpszFlags

Il peut s’agir de « wait », « notify », « test » ou d’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 d’erreur dans le cas contraire.

Notes

Cette commande peut échouer si l’appareil lit actuellement une vidéo de mouvement ou exécute une autre opération nécessitant beaucoup de ressources. Si la mémoire tampon d’images 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

Mettre