comando where

  • Articolo

Il comando where recupera il rettangolo che specifica l'area di origine o di destinazione. Questo rettangolo è stato specificato usando il comando put . I dispositivi digital-video e video-overlay 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("where %s %s %s"), 
  lpszDeviceID, 
  lpszRequestRect, 
  lpszFlags
);

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato all'apertura del dispositivo.

lpszRequestRect

Flag che identifica il rettangolo le cui dimensioni vengono recuperate. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando e i flag usati da ogni tipo.

Valore Significato Significato
digitalvideo destinationdestination maxframeframe maxsource source maxvideovideo maxwindow max
overlay destinationframe sourcevideo

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

Valore Significato
destination Recupera l'offset di destinazione e l'extent. Per i dispositivi di sovrapposizione video, il rettangolo di destinazione definisce l'area del client della finestra di visualizzazione che visualizza i dati dell'immagine dal buffer dei fotogrammi.
destinazione max Recupera le dimensioni correnti del rettangolo client.
frame Recupera l'offset e l'extent del rettangolo del buffer dei frame. Il rettangolo del buffer dei fotogrammi definisce l'area del buffer dei fotogrammi che riceve i dati video in ingresso. Le immagini del rettangolo "video" vengono ridimensionate in questa area.
frame max Restituisce la dimensione massima del buffer dei fotogrammi.
source Recupera l'offset di origine e l'extent. Per i dispositivi di sovrapposizione video, il rettangolo di origine definisce l'area del buffer dei fotogrammi visualizzato nella finestra di destinazione. Il dispositivo usa questo rettangolo per ritagliare l'immagine prima che venga estesa per adattare il rettangolo di destinazione sullo schermo.
source max Recupera le dimensioni massime del buffer dei frame.
Video Recupera l'offset e l'extent del rettangolo video. Il rettangolo video definisce l'area dei dati video in ingresso trasferiti nel buffer dei fotogrammi.
video max Restituisce la dimensione massima dell'input.
Finestra Recupera le dimensioni correnti e la posizione del frame della finestra di visualizzazione.
finestra max Recupera le dimensioni dell'intero display.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Flag di attesa, notifica e test.

Valore restituito

Restituisce un rettangolo nel parametro lpszReturnString della funzione mciSendString . Il rettangolo descrive l'area specificata nel parametro lpszRequestRect di questo comando. Il rettangolo 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.

Esempio

Il comando seguente restituisce il rettangolo di visualizzazione del dispositivo "movie".

where movie destination

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI

Mettere