comando MCI_RECORD

El comando MCI_RECORD inicia la grabación desde la posición actual o desde una ubicación especificada a otra ubicación especificada. Los dispositivos VCR y de audio de forma de onda reconocen este comando. Aunque los dispositivos de vídeo digital y los secuenciadores MIDI también reconocen este comando, los controladores MCIAVI y MCISEQ no lo implementan.

Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.

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

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o, para dispositivos de vídeo digital y VCR, MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.

lpRecord

Puntero a una estructura de MCI_RECORD_PARMS . (Los dispositivos con conjuntos de comandos extendidos pueden reemplazar esta estructura por una estructura específica del dispositivo).

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario.

Comentarios

Este comando es compatible con los dispositivos que devuelven TRUE cuando se llama al comando MCI_GETDEVCAPS con la marca MCI_GETDEVCAPS_CAN_RECORD. Para el controlador MCIWAVE, todos los datos registrados después de abrir un archivo se descartan si el archivo se cierra sin guardarlo.

Las siguientes marcas adicionales se aplican a todos los dispositivos que admiten MCI_RECORD:

MCI_FROM

Una ubicación inicial se incluye en el miembro dwFrom de la estructura identificada por lpRecord. Las unidades asignadas a los valores de posición se especifican con la marca MCI_SET_TIME_FORMAT del comando MCI_SET . Si no se especifica MCI_FROM, la ubicación inicial tiene como valor predeterminado la posición actual.

MCI_RECORD_INSERT

La información recién registrada debe insertarse o pegarse en los datos existentes. Es posible que algunos dispositivos no admitan esto. Si se admite, este es el valor predeterminado.

MCI_RECORD_OVERWRITE

Los datos deben sobrescribir los datos existentes. The MCIWAVE. El dispositivo DRV devuelve MCIERR_UNSUPPORTED_FUNCTION en respuesta a esta marca.

MCI_TO

Una ubicación final se incluye en el miembro dwTo de la estructura identificada por lpRecord. Las unidades asignadas a los valores de posición se especifican con la marca MCI_SET_TIME_FORMAT del comando MCI_SET . Si no se especifica MCI_TO, la ubicación final tiene como valor predeterminado el final del contenido.

Las siguientes marcas adicionales se usan con el tipo de dispositivo digitalvideo :

MCI_DGV_RECORD_AUDIO_STREAM

Un número de secuencia de audio se incluye en el miembro dwAudioStream de la estructura identificada por lpRecord. Si omite esta marca, los datos de audio se graban en la primera secuencia física.

MCI_DGV_RECORD_HOLD

Cuando se detenga la grabación, la pantalla contendrá la última imagen y no se reanudará mostrando el vídeo hasta que se emita un comando de MCI_MONITOR .

MCI_DGV_RECORD_VIDEO_STREAM

Un número de secuencia de vídeo se incluye en el miembro dwVideoStream de la estructura identificada por lpRecord. Si omite esta marca, los datos de vídeo se graban en la primera secuencia física.

MCI_DGV_RECT

Se especifica un rectángulo en el miembro rc de la estructura identificada por lpRecord. El rectángulo especifica la región de la entrada externa utilizada como origen para los píxeles comprimidos y guardados. Este rectángulo tiene como valor predeterminado el rectángulo especificado (o predeterminado) por la marca MCI_DGV_PUT_VIDEO para el comando MCI_PUT . Cuando se establece de forma diferente que el rectángulo de vídeo, lo que se muestra no es lo que se graba

En el caso de los dispositivos de vídeo digital, lpRecord apunta a una estructura de MCI_DGV_RECORD_PARMS .

Las siguientes marcas adicionales se usan con el tipo de dispositivo vcr :

MCI_VCR_RECORD_AT

El miembro dwAt de la estructura identificada por lpRecord contiene una hora en la que comienza todo el comando, o si el dispositivo está cued, cuando el dispositivo llega a la posición de la posición dada por el comando de indicación.

MCI_VCR_RECORD_INITIALIZE

Busque el dispositivo al inicio del medio, comience a grabar audio y vídeo en blanco y grabe el código de tiempo, si es posible.

En el caso de los dispositivos VCR, lpRecord apunta a una estructura de MCI_VCR_RECORD_PARMS .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Mmsystem.h (incluya Windows.h)

Consulte también

MCI

Comandos MCI