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.

Valore restituito

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

Commenti

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 .

Requisiti

Vedi anche

MCI

Comandi MCI