where command

Artículo
06/13/2023

El comando where recupera el rectángulo que especifica el área de origen o destino. Este rectángulo se especificó mediante el comando put . Los dispositivos digitales de vídeo y superposición de vídeo reconocen este comando.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

_stprintf_s(
  lpszCommand, 
  TEXT("where %s %s %s"), 
  lpszDeviceID, 
  lpszRequestRect, 
  lpszFlags
);

Parámetros

lpszDeviceID

Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.

lpszRequestRect

Marca que identifica el rectángulo cuyas dimensiones se recuperan. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando where y las marcas usadas por cada tipo.

Value	Significado	Significado
digitalvideo	destinationdestination maxframeframe maxsource	source maxvideovideo maxwindowwindow max
overlay	destinationframe	sourcevideo

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszRequestRect y sus significados.

Value	Significado
destination	Recupera el desplazamiento y la extensión de destino. En el caso de los dispositivos de superposición de vídeo, el rectángulo de destino define el área del cliente de la ventana de visualización que muestra los datos de imagen del búfer de fotogramas.
destination max	Recupera el tamaño actual del rectángulo de cliente.
frame	Recupera el desplazamiento y la extensión del rectángulo del búfer de fotogramas. El rectángulo de búfer de fotogramas define el área del búfer de fotogramas que recibe los datos de vídeo entrantes. Las imágenes del rectángulo "vídeo" se escalan a esta región.
frame max	Devuelve el tamaño máximo del búfer de fotogramas.
source	Recupera el desplazamiento y la extensión de origen. En el caso de los dispositivos de superposición de vídeo, el rectángulo de origen define la región del búfer de fotogramas que se muestra en la ventana de destino. El dispositivo usa este rectángulo para recortar la imagen antes de que se ajuste al rectángulo de destino en la pantalla.
source max	Recupera el tamaño máximo del búfer de fotogramas.
video	Recupera el desplazamiento y la extensión del rectángulo de vídeo. El rectángulo de vídeo define la región de los datos de vídeo entrantes que se transfieren al búfer de fotogramas.
máximo de vídeo	Devuelve el tamaño máximo de la entrada.
periodo	Recupera el tamaño y la posición actuales del marco de la ventana de presentación.
window max	Recupera el tamaño de toda la pantalla.

lpszFlags

Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital, también se puede especificar "prueba". Para obtener más información sobre estas marcas, vea Las marcas Wait, Notify y Test.

Valor devuelto

Devuelve un rectángulo en el parámetro lpszReturnString de la función mciSendString . El rectángulo describe el área especificada en el parámetro lpszRequestRect de este comando. El rectángulo se especifica como X1 Y1 X2 Y2. Las coordenadas X1 Y1 especifican la esquina superior izquierda del rectángulo y las coordenadas X2 Y2 especifican el ancho y el alto.

Ejemplos

El siguiente comando devuelve el rectángulo de presentación del dispositivo "movie".

where movie destination

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]

Consulte también

MCI
Cadenas de comandos de MCI
put