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 |
|