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