Comando save

Articolo
06/13/2023

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]

Vedi anche

MCI
Stringhe di comando MCI
Catturare
Riserva

Condividi tramite