Leer en inglés

Compartir a través de


Comando save

El comando save guarda un archivo MCI. Los dispositivos de audio de forma de onda y superposición de vídeo 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 admiten.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

_stprintf_s(
  lpszCommand, 
  TEXT("save %s %s %s"), 
  lpszDeviceID, 
  lpszFilename, 
  lpszFlags
); 

Parámetros

lpszDeviceID

Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.

lpszFilename

Marca que especifica el nombre del archivo que se va a guardar y, opcionalmente, marcas adicionales que modifican la operación de guardado. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando save y las marcas usadas por cada tipo.

Valor Significado Significado
digitalvideo anular en el rectángulo nombre de archivokeepreserve
overlay en rectángulo filename
sequencer filename
waveaudio filename

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszFilename y sus significados.

Valor Significado
anular Detiene una operación de guardado en curso. Si se usa, debe ser el único elemento presente.
en rectángulo Especifica un rectángulo relativo al origen del búfer de fotogramas. El rectángulo se especifica como X1 Y1 X2 Y2. Las coordenadas X1 Y1 especifican la esquina superior izquierda y las coordenadas X2 Y2 especifican el ancho y alto. En el caso de los dispositivos de vídeo digital, el comando capture se usa para capturar el contenido del búfer de fotogramas.
filename Especifica el nombre de archivo que se va a asignar al archivo de datos. Si no se especifica una ruta de acceso, el archivo se colocará en el disco y en el directorio especificado previamente en el comando de reserva explícito o implícito. Si no se ha emitido la reserva , la unidad predeterminada y el directorio son los asociados a la tarea de la aplicación. Si se especifica una ruta de acceso, el dispositivo puede requerir que esté en la unidad de disco especificada por la reserva explícita o implícita. Se requiere esta marca.
keepreserve Especifica que el espacio en disco sin usar que queda del comando reserva original no está desasignado.

lpszFlags

Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital y VCR, también se puede especificar "prueba". Para obtener más información sobre estas marcas, vea Las marcas de espera, notificación y prueba.

Valor devuelto

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

Observaciones

La variable filename es necesaria si el dispositivo se abrió con el identificador de dispositivo "nuevo".

Ejemplos

El siguiente comando guarda todo el búfer de vídeo en un archivo denominado VCAPFILE. TGA.

save vboard c:\vcap\vcapfile.tga

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]

Vea también

MCI

Cadenas de comandos de MCI

capturar

reserva