comando capture

Il comando capture copia il contenuto del buffer frame e lo archivia nel file specificato. I dispositivi digital-video riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

_stprintf_s(
  lpszCommand, 
  TEXT("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
); 

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato quando il dispositivo viene aperto.

lpszCapture

Uno o più dei flag seguenti:

Valore Significato
come nome percorso Specifica il percorso di destinazione e il nome file per l'immagine acquisita. Questo flag è obbligatorio.
in rettangolo Specifica l'area rettangolare all'interno del buffer del frame che il dispositivo viene raccolto e salvato su disco. Se omesso, l'area ritagliata viene impostata per impostazione predefinita sul rettangolo specificato o predefinito in un comando "source " precedente per questa istanza del dispositivo.

lpszFlags

Può essere "wait", "notify", "test" o una combinazione di queste. Per altre informazioni su questi flag, vedere Attesa, notifica e flag di test.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

Questo comando potrebbe non riuscire se il dispositivo sta attualmente riproducendo video di movimento o eseguendo un'altra operazione a elevato utilizzo di risorse. Se il buffer del frame viene aggiornato in tempo reale, l'aggiornamento viene sospeso in modo che venga acquisita un'immagine completa. Se il dispositivo sospende l'aggiornamento, potrebbe verificarsi un effetto visivo o udibile. Se il formato di file, l'algoritmo di compressione e i livelli di qualità non sono stati impostati, vengono usati i valori predefiniti.

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

Mettere