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