comando MCI_FREEZE

Il comando MCI_FREEZE blocca il movimento sullo schermo. I dispositivi digital-video, video-overlay e VCR riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_FREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpFreeze
);

Parametri

wDeviceID: Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.
Dwflags: MCI_NOTIFY, MCI_WAIT o per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Flag di attesa, notifica e test.
lpFreeze: Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con parametri aggiuntivi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

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

I flag aggiuntivi seguenti vengono usati dal tipo di dispositivo digitalvideo :

MCI_DGV_FREEZE_AT: Il membro rc della struttura identificata da lpFreeze contiene un rettangolo valido. Il rettangolo specifica un'area all'interno del buffer dei fotogrammi che avrà il bit della maschera di blocco per ogni pixel attivato. I pixel specificati non verranno aggiornati finché il bit della maschera di blocco non viene disattivato. Se questo flag non viene specificato, per impostazione predefinita il rettangolo corrisponde all'intero buffer dei fotogrammi. Questo flag è supportato solo se il comando MCI_GETDEVCAPS restituisce TRUE per il flag MCI_DGV_GETDEVCAPS_CAN_LOCK.
MCI_DGV_FREEZE_OUTSIDE: L'area all'esterno dell'area specificata per il flag di MCI_DGV_FREEZE_AT è bloccata.

Per i dispositivi digital-video, il parametro lpFreeze punta a una struttura MCI_DGV_FREEZE_PARMS .

I flag aggiuntivi seguenti vengono usati dal tipo di dispositivo vcr :

MCI_VCR_FREEZE_FIELD: Blocca un solo membro del frame corrente.
MCI_VCR_FREEZE_FRAME: Bloccare entrambi i campi del frame corrente.
MCI_VCR_FREEZE_INPUT: Bloccare il frame corrente sullo schermo (usato per la registrazione).
MCI_VCR_FREEZE_OUTPUT: Bloccare il frame corrente dal registro virtuale (usato con l'acquisizione dei fotogrammi).

Per i dispositivi VCR, il parametro lpFreeze punta a una struttura MCI_GENERIC_PARMS .

Il flag aggiuntivo seguente viene usato dal tipo di dispositivo overlay :

MCI_OVLY_RECT: Il membro rc della struttura identificata da lpFreeze contiene un rettangolo valido. Se questo flag non viene specificato, il driver di dispositivo congelerà l'intero frame.

Per i dispositivi di sovrapposizione video, il parametro lpFreeze punta a una struttura MCI_OVLY_RECT_PARMS .

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Mmsystem.h (include Windows.h)