Comando save
Il comando salva un file MCI. I dispositivi video-overlay e waveform-audio riconoscono questo comando. Anche se i dispositivi digital-video e i sequencer MIDI riconoscono questo comando, i driver MCIAVI e MCISEQ non lo supportano.
Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.
_stprintf_s(
lpszCommand,
TEXT("save %s %s %s"),
lpszDeviceID,
lpszFilename,
lpszFlags
);
Parametri
-
lpszDeviceID
-
Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato all'apertura del dispositivo.
-
lpszFilename
-
Flag che specifica il nome del file salvato e, facoltativamente, flag aggiuntivi che modificano l'operazione di salvataggio. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando save e i flag usati da ogni tipo.
Valore Significato Significato digitalvideo interruzione in corrispondenza del rettangolo nomefilekeepreserve overlay in corrispondenza del rettangolo Filename sequencer Filename Waveaudio Filename Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszFilename e i relativi significati.
Valore Significato abort Arresta un'operazione di salvataggio in corso. Se usato, deve essere l'unico elemento presente. in corrispondenza del rettangolo Specifica un rettangolo relativo all'origine del buffer dei frame. Il rettangolo viene specificato come X1 Y1 X2 Y2. Le coordinate X1 Y1 specificano l'angolo superiore sinistro e le coordinate X2 Y2 specificano la larghezza e l'altezza. Per i dispositivi digital-video, il comando capture viene usato per acquisire il contenuto del buffer dei fotogrammi. Filename Specifica il nome file da assegnare al file di dati. Se non viene specificato un percorso, il file verrà inserito sul disco e nella directory specificata in precedenza nel comando di riserva esplicito o implicito. Se la riserva non è stata eseguita, l'unità predefinita e la directory sono quelle associate all'attività dell'applicazione. Se viene specificato un percorso, il dispositivo potrebbe richiedere che si trova nell'unità disco specificata dalla riserva esplicita o implicita. Questo flag è obbligatorio. keepreserve Specifica che lo spazio su disco inutilizzato lasciato dal comando di riserva originale non viene deallocato. -
lpszFlags
-
Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video e VCR, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Flag di attesa, notifica e test.
Valore restituito
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.
Commenti
La variabile nome file è necessaria se il dispositivo è stato aperto usando l'identificatore del dispositivo "nuovo".
Esempio
Il comando seguente salva l'intero buffer video in un file denominato VCAPFILE. TGA.
save vboard c:\vcap\vcapfile.tga
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |