comando MCI_RECORD

Il comando MCI_RECORD avvia la registrazione dalla posizione corrente o da una posizione specificata a un'altra posizione specificata. 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 mciSendCommand con i parametri seguenti.

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

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o, per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.

lpRecord

Puntatore a una struttura MCI_RECORD_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

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

Commenti

Questo comando è supportato dai dispositivi che restituiscono TRUE quando si chiama il comando MCI_GETDEVCAPS con il flag di MCI_GETDEVCAPS_CAN_RECORD . Per il driver MCIWAVE, tutti i dati registrati dopo l'apertura di un file vengono eliminati se il file viene chiuso senza salvarlo.

I flag aggiuntivi seguenti si applicano a tutti i dispositivi che supportano MCI_RECORD:

MCI_FROM

Una posizione iniziale è inclusa nel membro dwFrom della struttura identificata da lpRecord. Le unità assegnate ai valori di posizione vengono specificate con il flag MCI_SET_TIME_FORMAT del comando MCI_SET . Se MCI_FROM non è specificato, la posizione iniziale è predefinita per la posizione corrente.

MCI_RECORD_INSERT

Le informazioni appena registrate devono essere inserite o incollate nei dati esistenti. Alcuni dispositivi potrebbero non supportare questo problema. Se supportato, si tratta dell'impostazione predefinita.

MCI_RECORD_OVERWRITE

I dati devono sovrascrivere i dati esistenti. The MCIWAVE. Il dispositivo DRV restituisce MCIERR_UNSUPPORTED_FUNCTION in risposta a questo flag.

MCI_TO

Una posizione finale è inclusa nel membro dwTo della struttura identificata da lpRecord. Le unità assegnate ai valori di posizione vengono specificate con il flag MCI_SET_TIME_FORMAT del comando MCI_SET . Se MCI_TO non è specificato, la posizione finale viene predefinita alla fine del contenuto.

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo digitalvideo :

MCI_DGV_RECORD_AUDIO_STREAM

Un numero di flusso audio è incluso nel membro dwAudioStream della struttura identificata da lpRecord. Se si omette questo flag, i dati audio vengono registrati nel primo flusso fisico.

MCI_DGV_RECORD_HOLD

Quando la registrazione si arresta, la schermata conterrà l'ultima immagine e non riprenderà a visualizzare il video finché non viene rilasciato un comando MCI_MONITOR .

MCI_DGV_RECORD_VIDEO_STREAM

Un numero di flusso video è incluso nel membro dwVideoStream della struttura identificata da lpRecord. Se si omette questo flag, i dati video vengono registrati nel primo flusso fisico.

MCI_DGV_RECT

Un rettangolo viene specificato nel membro rc della struttura identificata da lpRecord. Il rettangolo specifica l'area dell'input esterno usato come origine per i pixel compressi e salvati. Questo rettangolo viene impostato per impostazione predefinita sul rettangolo specificato (o predefinito) dal flag di MCI_DGV_PUT_VIDEO per il comando MCI_PUT . Quando viene impostato in modo diverso dal rettangolo video, ciò che viene visualizzato non è ciò che viene registrato

Per i dispositivi digital-video, lpRecord punta a una struttura MCI_DGV_RECORD_PARMS .

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo vcr :

MCI_VCR_RECORD_AT

Il membro dwAt della struttura identificata da lpRecord contiene un'ora in cui l'intero comando inizia o se il dispositivo viene cuedo, quando il dispositivo raggiunge la posizione dalla posizione specificata dal comando cue.

MCI_VCR_RECORD_INITIALIZE

Cercare il dispositivo all'inizio del supporto, iniziare a registrare video e audio vuoti e registrare il codice temporale, se possibile.

Per i dispositivi VCR, lpRecord punta a una struttura MCI_VCR_RECORD_PARMS .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI