Partager via


commande MCI_RECORD

La commande MCI_RECORD démarre l’enregistrement à partir de la position actuelle ou d’un emplacement spécifié à un autre emplacement spécifié. Les appareils VCR et waveform-audio reconnaissent cette commande. Bien que les périphériques vidéo numériques et les séquenceurs MIDI reconnaissent également cette commande, les pilotes MCIAVI et MCISEQ ne l’implémentent pas.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RECORD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_RECORD_PARMS) lpRecord
);

Paramètres

wDeviceID

Identificateur de l’appareil MCI devant recevoir le message de commande.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, pour les appareils de vidéo numérique et de magnétoscope, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.

lpRecord

Pointeur vers une structure MCI_RECORD_PARMS . (Les appareils avec des jeux de commandes étendus peuvent remplacer cette structure par une structure spécifique à l’appareil.)

Valeur renvoyée

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

Notes

Cette commande est prise en charge par les appareils qui retournent TRUE lorsque vous appelez la commande MCI_GETDEVCAPS avec l’indicateur MCI_GETDEVCAPS_CAN_RECORD. Pour le pilote MCIWAVE, toutes les données enregistrées après l’ouverture d’un fichier sont ignorées si le fichier est fermé sans l’enregistrer.

Les indicateurs supplémentaires suivants s’appliquent à tous les appareils prenant en charge MCI_RECORD :

MCI_FROM

Un emplacement de départ est inclus dans le membre dwFrom de la structure identifiée par lpRecord. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de la commande MCI_SET . Si MCI_FROM n’est pas spécifié, l’emplacement de départ est défini par défaut sur la position actuelle.

MCI_RECORD_INSERT

Les informations nouvellement enregistrées doivent être insérées ou collées dans les données existantes. Certains appareils peuvent ne pas le prendre en charge. S’il est pris en charge, il s’agit de la valeur par défaut.

MCI_RECORD_OVERWRITE

Les données doivent remplacer les données existantes. The MCIWAVE. L’appareil DRV retourne MCIERR_UNSUPPORTED_FUNCTION en réponse à cet indicateur.

MCI_TO

Un emplacement de fin est inclus dans le membre dwTo de la structure identifiée par lpRecord. Les unités affectées aux valeurs de position sont spécifiées avec l’indicateur MCI_SET_TIME_FORMAT de la commande MCI_SET . Si MCI_TO n’est pas spécifié, l’emplacement de fin est défini par défaut sur la fin du contenu.

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil digitalvideo :

MCI_DGV_RECORD_AUDIO_STREAM

Un numéro de flux audio est inclus dans le membre dwAudioStream de la structure identifiée par lpRecord. Si vous omettez cet indicateur, les données audio sont enregistrées dans le premier flux physique.

MCI_DGV_RECORD_HOLD

Lorsque l’enregistrement s’arrête, l’écran contient la dernière image et ne reprend pas l’affichage de la vidéo tant qu’une commande MCI_MONITOR n’est pas émise.

MCI_DGV_RECORD_VIDEO_STREAM

Un numéro de flux vidéo est inclus dans le membre dwVideoStream de la structure identifiée par lpRecord. Si vous omettez cet indicateur, les données vidéo sont enregistrées dans le premier flux physique.

MCI_DGV_RECT

Un rectangle est spécifié dans le membre rc de la structure identifiée par lpRecord. Le rectangle spécifie la région de l’entrée externe utilisée comme source pour les pixels compressés et enregistrés. Ce rectangle est défini par défaut sur le rectangle spécifié (ou défini par défaut) par l’indicateur MCI_DGV_PUT_VIDEO pour la commande MCI_PUT . Lorsqu’il est défini différemment du rectangle vidéo, ce qui est affiché n’est pas ce qui est enregistré

Pour les appareils vidéo numériques, lpRecord pointe vers une structure MCI_DGV_RECORD_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil vcr :

MCI_VCR_RECORD_AT

Le membre dwAt de la structure identifiée par lpRecord contient une heure à laquelle la commande entière commence, ou si l’appareil est cued, lorsque l’appareil atteint la position à partir de donnée par la commande d’indicateur.

MCI_VCR_RECORD_INITIALIZE

Recherchez l’appareil jusqu’au début du média, commencez l’enregistrement vidéo et audio vides, puis enregistrez le code temporel, si possible.

Pour les appareils vcR, lpRecord pointe vers une structure MCI_VCR_RECORD_PARMS .

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]
En-tête
Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI