Comando record

Il comando record avvia la registrazione dei dati. I dispositivi VCR e waveform-audio riconoscono questo comando. Anche se i dispositivi digitali e i sequencer MIDI riconoscono anche questo comando, i driver MCIAVI e MCISEQ non lo implementano.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

_stprintf_s(
  lpszCommand, 
  TEXT("record %s %s %s"), 
  lpszDeviceID, 
  lpszRecordFlags, 
  lpszFlags
); 

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato quando il dispositivo viene aperto.

lpszRecordFlags

Contrassegno per la registrazione dei dati. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando record e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	in flussoaudio rettangolodal blocco della posizione	inserisci sovrascrivere per posizionareil flusso video
sequencer	dall'inserimento della posizione	sovrascrivere la posizione
Vcr	al momentodall'inizializzazione della posizione	inserisci sovrascrivere in posizione
Waveaudio	dall'inserimento della posizione	sovrascrivere la posizione

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszRecordFlags e i relativi significati.

Valore	Significato
in rettangolo	Specifica un'area rettangolare dell'input esterno usato come origine per i pixel compressi e salvati. Se non specificato, il rettangolo viene impostato per impostazione predefinita sul rettangolo specificato per inserire "video". Quando viene impostato in modo diverso dal rettangolo "video", l'immagine visualizzata non è quella registrata.
al momento	Indica quando il dispositivo deve iniziare a eseguire questo comando o, se il dispositivo è stato cued, quando inizia il comando cued. Per altre informazioni, vedere il comando cue .
Flusso di flusso audio	Specifica il flusso audio usato per la registrazione. Se questo flag non è specificato e il formato di file non definisce un valore predefinito, viene registrato nel flusso che è fisicamente.
dalla posizione	Specifica una posizione iniziale per la registrazione. Se il flag "from" non è specificato, il dispositivo avvia la registrazione nella posizione corrente.
Tenere	Blocca l'immagine al termine della registrazione anziché visualizzare video live. Quando la registrazione si arresta, viene eseguito un comando "file" di monitoraggio automatico. Per tornare al video live, eseguire il comando monitor "input".
inizializzazione	Inizializzare il nastro (supporto), che implica la registrazione del codice temporale (se possibile) per video e audio vuoti. Questo comando potrebbe richiedere diverse ore se l'intero nastro deve essere inizializzato.
insert	Specifica che i nuovi dati vengono aggiunti al file nella posizione corrente.
overwrite	Specifica che i nuovi dati sostituiranno i dati nel file.
per posizionare	Specifica una posizione finale per la registrazione. Se il flag "to" non è specificato, il dispositivo registra fino a quando non riceve un comando di arresto o sospensione .
flusso video	Specifica il flusso video usato per la registrazione. Se non viene specificato e il formato di file non definisce un valore predefinito, viene registrato nel flusso che è fisicamente.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video e VCR, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Attesa, notifica e flag di test.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

La registrazione si arresta quando viene generato un comando stop o pause . Per il driver MCIWAVE, tutti i dati registrati dopo l'apertura di un file vengono eliminati se il file viene chiuso senza salvarlo.

Prima di eseguire tutti i comandi che usano i valori di posizione, è necessario impostare il formato di tempo desiderato usando il comando set . Le tracce da registrare sono specificate dai comandi settimecode "record", set "assembly record", setvideo "record" e setaudio "record".

Esempio

Il comando seguente avvia la registrazione nella posizione corrente.

record mysound

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI

segnale

monitoraggio

pause

Mettere

set

setaudio

settimecode

setvideo

stop