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