comando MCI_WHERE

Il comando MCI_WHERE ottiene il rettangolo di ritaglio per il dispositivo video. I dispositivi di sovrimpressione digitale e video riconoscono questo comando. I membri superiore e sinistro del RECT restituito contengono l'origine del rettangolo di ritaglio e i membri di destra e inferiore contengono la larghezza e l'altezza del rettangolo di ritaglio. Non è l'uso standard dei membri destro e inferiore .

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WHERE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);

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.

lpQuery

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_WHERE_DESTINATION

Ottiene una descrizione dell'area rettangolare usata per visualizzare video e immagini nell'area client della finestra corrente.

MCI_DGV_WHERE_FRAME

Ottiene una descrizione dell'area rettangolare del buffer fotogramma in cui vengono ridimensionate le immagini dal rettangolo video. Le coordinate del rettangolo vengono posizionate nel membro rc della struttura identificata da lpQuery.

MCI_DGV_WHERE_MAX

Se usato con MCI_DGV_WHERE_DESTINATION o MCI_DGV_WHERE_SOURCE, il rettangolo restituito indica la larghezza massima e l'altezza dell'area specificata. Se usato con MCI_DGV_WHERE_WINDOW, il rettangolo restituito indica le dimensioni dell'intero display.

MCI_DGV_WHERE_SOURCE

Ottiene una descrizione dell'area rettangolare (ritagliata dal buffer del frame) estesa per adattare il rettangolo di destinazione sulla visualizzazione.

MCI_DGV_WHERE_VIDEO

Ottiene una descrizione dell'area rettangolare ritagliata dall'origine della presentazione per riempire il rettangolo del frame nel buffer del frame. Le coordinate del rettangolo vengono posizionate nel membro rc della struttura identificata da lpQuery.

MCI_DGV_WHERE_WINDOW

Ottiene una descrizione della cornice della finestra di visualizzazione.

Per i dispositivi digital-video, il parametro lpQuery punta a una struttura MCI_DGV_WHERE_PARMS . La struttura MCI_DGV_WHERE_PARMS è identica alla struttura MCI_DGV_RECT_PARMS .

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

MCI_OVLY_WHERE_DESTINATION

Ottiene il rettangolo di visualizzazione della destinazione. Le coordinate del rettangolo vengono posizionate nel membro rc della struttura identificata da lpQuery.

MCI_OVLY_WHERE_FRAME

Ottiene il rettangolo della cornice di sovrapposizione. Le coordinate del rettangolo vengono posizionate nel membro rc della struttura identificata da lpQuery.

MCI_OVLY_WHERE_SOURCE

Ottiene il rettangolo di origine. Le coordinate del rettangolo vengono posizionate nel membro rc della struttura identificata da lpQuery.

MCI_OVLY_WHERE_VIDEO

Ottiene il rettangolo video. Le coordinate del rettangolo vengono posizionate nel membro rc della struttura identificata da lpQuery.

Per i dispositivi di sovrapposizione video, il parametro lpQuery 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