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