comando MCI_PUT

Il comando MCI_PUT imposta i rettangoli di origine, destinazione e frame. I dispositivi di sovrimpressione digitale e video riconoscono questo comando.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o, per dispositivi video digitali, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.

lpDest

Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

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

Commenti

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo digitalvideo :

MCI_DGV_PUT_CLIENT

Il rettangolo definito per MCI_DGV_RECT si applica alla posizione della finestra client. Il rettangolo specificato è relativo alla finestra padre della finestra di visualizzazione. MCI_DGV_PUT_WINDOW deve essere impostato simultaneamente con questo flag.

MCI_DGV_PUT_DESTINATION

Il rettangolo definito per MCI_DGV_RECT specifica un rettangolo di destinazione. Il rettangolo di destinazione specifica la parte della finestra client associata a questa istanza del driver di dispositivo che mostra l'immagine o il video.

MCI_DGV_PUT_FRAME

Il rettangolo definito per MCI_DGV_RECT si applica al rettangolo di cornice. Il rettangolo del fotogramma specifica la parte del buffer frame usato come destinazione delle immagini video ottenute dal rettangolo video. Il video deve essere ridimensionato per adattarsi all'interno del rettangolo del buffer del frame.

Il rettangolo viene specificato nelle coordinate del buffer del frame. Il rettangolo predefinito è il buffer full frame. La specifica di questo rettangolo consente al dispositivo di ridimensionare l'immagine man mano che digitalizza i dati. I dispositivi che non possono ridimensionare l'immagine rifiutano questo comando con MCIERR_UNSUPPORTED_FUNCTION. È possibile usare il flag MCI_GETDEVCAPS_CAN_STRETCH con il comando MCI_GETDEVCAPS per determinare se un dispositivo ridimensiona l'immagine. Un dispositivo restituisce FALSE se non riesce a ridimensionare l'immagine.

MCI_DGV_PUT_SOURCE

Il rettangolo definito per MCI_DGV_RECT specifica un rettangolo di origine. Il rettangolo di origine specifica la parte del buffer frame da ridimensionare per adattarsi al rettangolo di destinazione.

MCI_DGV_PUT_VIDEO

Il rettangolo definito per MCI_DGV_RECT si applica al rettangolo video. Il rettangolo video specifica la parte dell'origine della presentazione corrente archiviata nel buffer dei fotogrammi. Il rettangolo viene specificato usando le coordinate naturali dell'origine della presentazione. Consente la specifica del ritaglio che si verifica prima di archiviare immagini e video nel buffer dei fotogrammi. Il rettangolo predefinito è l'area di analisi attiva completa o le immagini e i video decompressi completi.

MCI_DGV_PUT_WINDOW

Il rettangolo definito per MCI_DGV_RECT si applica alla finestra di visualizzazione. Questo rettangolo è relativo alla finestra padre della finestra di visualizzazione (in genere il desktop). Se la finestra non è specificata, viene predefinita per impostazione predefinita la dimensione e la posizione iniziale della finestra.

MCI_DGV_RECT

Il membro rc della struttura identificata da lpDest contiene un rettangolo valido.

Per i dispositivi digital-video, lpDest punta a una struttura MCI_DGV_PUT_PARMS .

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo sovrimpressione :

MCI_OVLY_PUT_DESTINATION

Il rettangolo definito per MCI_OVLY_RECT specifica l'area della finestra client usata per visualizzare un'immagine. Il rettangolo contiene l'offset e l'estensione visibile dell'immagine rispetto all'origine della finestra. Se il frame viene esteso, l'origine viene estesa al rettangolo di destinazione.

MCI_OVLY_PUT_FRAME

Il rettangolo definito per MCI_OVLY_RECT specifica l'area del buffer video usato per ricevere l'immagine video. Il rettangolo contiene l'offset e l'estensione dell'area del buffer rispetto all'origine del buffer video.

MCI_OVLY_PUT_SOURCE

Il rettangolo definito per MCI_OVLY_RECT specifica l'area del buffer video usato come origine dell'immagine digitale. Il rettangolo contiene l'offset e l'estensione del rettangolo di ritaglio per il buffer video rispetto all'origine.

MCI_OVLY_PUT_VIDEO

Il rettangolo definito per MCI_OVLY_RECT specifica l'area dell'acquisizione dell'origine video dal buffer video. Il rettangolo contiene l'offset e l'estensione del rettangolo di ritaglio per l'origine video rispetto all'origine.

MCI_OVLY_RECT

Il membro rc della struttura identificata da lpDest contiene un rettangolo di visualizzazione valido. Se questo flag non è specificato, il rettangolo predefinito corrisponde alle coordinate del buffer video o della finestra da ritagliare.

Per i dispositivi di sovrapposizione video, lpDest punta a una struttura MCI_OVLY_RECT_PARMS.

Requisiti

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)

Vedi anche

MCI

Comandi MCI