Comando put

El comando put define el área de la imagen de origen y la ventana de destino que se usa para mostrar. Los dispositivos de superposición de vídeo y vídeo digital 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("put %s %s %s"), 
  lpszDeviceID, 
  lpszRegions, 
  lpszFlags
); 

Parámetros

lpszDeviceID

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

lpszRegions

Marca para definir el área. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando put y las marcas usadas por cada tipo.

Valor	Significado	Significado
digitalvideo	destino de destino en el marco de rectánguloen el origen del rectánguloen el rectángulo	vídeo de vídeo en la ventana de ventana de rectánguloen el cliente de ventana de ventana de rectánguloen el rectángulo
overlay	destino de destino en marco de rectánguloen rectángulo	origen de origen en vídeo de rectánguloen rectángulo

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

Valor	Significado
destination	Selecciona todo el área de cliente de la ventana de destino para mostrar los datos.
destino en rectángulo	Selecciona una parte del área de cliente de la ventana de destino que se usa para mostrar la imagen. Cuando se especifica un área de la ventana de presentación y el dispositivo admite la extensión, la imagen de origen se extiende hasta el desplazamiento y la extensión de destino.
frame	Selecciona todo el búfer de fotogramas para recibir las imágenes de vídeo entrantes.
marco en rectángulo	Selecciona una parte del búfer de fotogramas para recibir las imágenes de vídeo entrantes.
source	Selecciona toda la imagen para mostrarla en la ventana de destino.
source at rectangle	Selecciona una parte de la imagen que se va a mostrar en la ventana de destino. Cuando se especifica un área de la imagen de origen y el dispositivo admite la extensión, la imagen de origen se extiende hasta el desplazamiento y la extensión de destino.
video	Selecciona toda la imagen de vídeo entrante que se va a capturar en el búfer de fotogramas.
vídeo en rectángulo	Selecciona una parte de la imagen de vídeo entrante para capturar en el búfer de fotogramas.
periodo	Restaura el tamaño inicial de la ventana en la pantalla. Este comando también muestra la ventana.
ventana en rectángulo	Cambia el tamaño y la ubicación de la ventana de presentación. El rectángulo especificado es relativo a la ventana primaria de la ventana de presentación (normalmente el escritorio) si se ha usado la marca "style child" para el comando open . Para cambiar la ubicación de la ventana sin cambiar su alto o ancho, especifique cero para el alto y el ancho.
cliente de ventana	Restaura el área de cliente de la ventana.
cliente de ventana en el rectángulo	Cambia el tamaño y la ubicación del área de cliente de la ventana. El rectángulo especificado es relativo a la ventana primaria de la ventana de cliente. Para cambiar la ubicación de la ventana sin cambiar su alto o ancho, especifique cero para el alto y el ancho.

Cuando una marca incluye un rectángulo, las coordenadas del rectángulo son relativas al origen de la ventana o al origen de la imagen, según corresponda, y se especifican como X1 Y1 X2 Y2. Las coordenadas X1Y1 especifican la esquina superior izquierda y las coordenadas X2Y2 especifican el ancho y alto del rectángulo.

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 cero si es correcto o si se produce un error de lo contrario.

Comentarios

El comando put define uno o varios de los rectángulos siguientes al trabajar con dispositivos de superposición de vídeo:

• El rectángulo de vídeo define la región de la imagen de vídeo entrante que se va a capturar.
• El rectángulo de fotogramas define la región del búfer de fotogramas que recibe la imagen de vídeo entrante.
• El rectángulo de origen define la región del búfer de fotogramas que se copia en el rectángulo de destino.
• El rectángulo de destino define la región del área cliente de la ventana de presentación que recibe la imagen de vídeo.

El rectángulo de vídeo está relacionado con el rectángulo de marco de la misma manera que el rectángulo de origen está relacionado con el rectángulo de destino. La extensión puede producirse desde el rectángulo de vídeo hasta el rectángulo de marco y desde el rectángulo de origen hasta el rectángulo de destino. No todos los dispositivos admiten la extensión y la extensión debe estar habilitada (mediante el comando set ).

El siguiente comando define tres regiones para el vídeo, el marco y el origen.

put vboard video 120 120 200 200 frame 0 0 200 200 source 0 0 200 200

Las regiones de este ejemplo se definen de la siguiente manera:

• Una región de 200 x 200 píxeles de los datos de vídeo entrantes, a partir de un origen de 120 píxeles desde la esquina superior izquierda, se capturará en el búfer de fotogramas.
• Los datos de vídeo se colocarán en una región de 200 x 200 píxeles en la esquina superior izquierda del búfer de fotogramas.
• Las transferencias se realizan desde la región de 200 a 200 píxeles en la esquina superior izquierda del búfer de fotogramas a la ventana de destino.

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

open

set