blocco comando

Il comando di blocco blocca l'input video o l'output video in un registro virtuale o disabilita l'acquisizione video nel buffer dei fotogrammi. I dispositivi digital-video, sovrimpressione video e VCR 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("freeze %s %s %s"), 
  lpszDeviceID, 
  lpszFreezeFlags, 
  lpszFlags
); 

Parametri

lpszDeviceID

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

lpszFreezeFlags

Flag che identifica cosa bloccare. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando di blocco e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	in rettangolo	Fuori
overlay	in rettangolo
Vcr	campo frame	input output

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszFreezeFlags e i relativi significati.

Valore	Significato
in rettangolo	Specifica l'area che verrà bloccata. Per i dispositivi di sovrapposizione video, questa area avrà l'acquisizione video disabilitata. Per i dispositivi digital-video, i pixel all'interno del rettangolo avranno il loro bit di maschera di blocco attivato (a meno che non sia specificato il flag "esterno"). Il rettangolo è relativo all'origine del buffer video e viene specificato come X1 Y1 X2 Y2. Le coordinate X1 Y1 specificano l'angolo superiore sinistro del rettangolo e le coordinate X2 Y2 specificano la larghezza e l'altezza.
campo	Blocca il primo campo. Il campo viene assunto per impostazione predefinita (se non viene specificato alcun frame o campo).
frame	Blocca l'intera cornice, visualizzando entrambi i campi.
input	Blocca il frame corrente dell'immagine di input, indipendentemente dal fatto che sia sospeso o in esecuzione.
output	Blocca il frame corrente dell'output dal registro virtuale. Se il registro virtuale viene riprodotto quando viene eseguito il blocco, il frame corrente viene bloccato e il registro virtuale viene sospeso. Se il registro virtuale viene sospeso quando viene rilasciato questo comando, il frame corrente viene bloccato. L'immagine bloccata rimane nel dispositivo di output fino a quando non viene rilasciato un comando di annullamento . Se non viene specificato "input" né "output", viene assunto "output".
Fuori	Indica che l'area esterna all'area specificata usando il flag "at" è bloccata.

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 Attesa, notifica e flag di test.

Valore restituito

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

Commenti

Se usato con i dispositivi VCR, questo comando è destinato alle schede di acquisizione frame.

Per specificare aree di acquisizione irregolari con il flag "at", usare una serie di comandi di blocco e annullamento del blocco . Alcuni dispositivi di sovrapposizione video limitano la complessità dell'area di acquisizione.

Questo comando è supportato solo se una chiamata al comando di funzionalità con il flag "can freeze" restituisce TRUE.

Esempio

Il comando seguente disabilita l'acquisizione video in un quadrato di 100 pixel nell'angolo superiore sinistro del buffer video.

freeze vboard at 0 0 100 100

Requisiti

Vedi anche

MCI

Stringhe di comando MCI

capability

Sbloccare