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