comando MCI_SAVE

El comando MCI_SAVE guarda el archivo actual. Los dispositivos que modifican archivos no deben destruir la copia original hasta que reciban el mensaje de guardado. 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 implementan.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SAVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SAVE_PARMS ) lpSave
);

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.

lpSave

Puntero a una estructura de MCI_SAVE_PARMS . (Los dispositivos con parámetros adicionales pueden reemplazar esta estructura por una estructura específica del dispositivo).

Valor devuelto

Devuelve cero si es correcto o si se produce un error de lo 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_SAVE.

La siguiente marca adicional se aplica a todos los dispositivos que admiten MCI_SAVE:

MCI_SAVE_FILE

El miembro lpfilename de la estructura identificada por lpSave contiene una dirección de un búfer que contiene el nombre de archivo de destino.

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

MCI_DGV_RECT

El miembro rc de la estructura identificada por lpSave contiene un rectángulo válido. El rectángulo especifica una región del búfer de fotogramas que se guardará en el archivo especificado. El primer par de coordenadas especifica la esquina superior izquierda del rectángulo; el segundo par especifica el ancho y el alto. Los dispositivos de vídeo digital deben usar el comando MCI_CAPTURE para capturar el contenido del búfer de fotogramas. (Los dispositivos de superposición de vídeo también deben usar MCI_CAPTURE). Esta marca es compatible con el conjunto de comandos de superposición de vídeo de MCI existente.

MCI_DGV_SAVE_ABORT

Detiene una operación de guardado en curso. Debe ser la única marca presente.

MCI_DGV_SAVE_KEEPRESERVE

No se desasigna el espacio en disco sin usar del comando MCI_RESERVE original.

En el caso de los dispositivos de vídeo digital, el parámetro lpSave apunta a una estructura de MCI_DGV_SAVE_PARMS .

La marca adicional siguiente se usa con el tipo de dispositivo de superposición :

MCI_OVLY_RECT

El miembro rc de la estructura identificada por lpSave contiene un rectángulo de pantalla válido que indica el área del búfer de vídeo que se va a guardar.

En el caso de los dispositivos de superposición de vídeo, el parámetro lpSave apunta a una estructura de MCI_OVLY_SAVE_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 (incluye Windows.h)

Consulte también

MCI

Comandos de MCI