comando MCI_PUT
El comando MCI_PUT establece los rectángulos de origen, destino y marco. Los dispositivos de superposición de vídeo y vídeo digital reconocen este comando.
Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_PUT,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpDest
);
Parámetros
-
wDeviceID
-
Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT o, para dispositivos de vídeo digital, MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.
-
lpDest
-
Puntero a una estructura de MCI_GENERIC_PARMS . (Los dispositivos con conjuntos de comandos extendidos pueden reemplazar esta estructura por una estructura específica del dispositivo).
Valor devuelto
Devuelve cero si es correcto o si se produce un error de lo contrario.
Observaciones
Las marcas adicionales siguientes se usan con el tipo de dispositivo digitalvideo :
-
MCI_DGV_PUT_CLIENT
-
El rectángulo definido para MCI_DGV_RECT se aplica a la posición de la ventana del cliente. El rectángulo especificado es relativo a la ventana primaria de la ventana de presentación. MCI_DGV_PUT_WINDOW debe establecerse simultáneamente con esta marca.
-
MCI_DGV_PUT_DESTINATION
-
El rectángulo definido para MCI_DGV_RECT especifica un rectángulo de destino. El rectángulo de destino especifica la parte de la ventana del cliente asociada a esta instancia del controlador de dispositivo que muestra la imagen o el vídeo.
-
MCI_DGV_PUT_FRAME
-
El rectángulo definido para MCI_DGV_RECT se aplica al rectángulo de marco. El rectángulo de fotogramas especifica la parte del búfer de fotogramas utilizado como destino de las imágenes de vídeo obtenidas del rectángulo de vídeo. El vídeo se debe escalar para ajustarse al rectángulo del búfer de fotogramas.
El rectángulo se especifica en coordenadas de búfer de fotogramas. El rectángulo predeterminado es el búfer de marco completo. Al especificar este rectángulo, el dispositivo escala la imagen a medida que digitaliza los datos. Los dispositivos que no pueden escalar la imagen rechazan este comando con MCIERR_UNSUPPORTED_FUNCTION. Puede usar la marca MCI_GETDEVCAPS_CAN_STRETCH con el comando MCI_GETDEVCAPS para determinar si un dispositivo escala la imagen. Un dispositivo devuelve FALSE si no puede escalar la imagen.
-
MCI_DGV_PUT_SOURCE
-
El rectángulo definido para MCI_DGV_RECT especifica un rectángulo de origen. El rectángulo de origen especifica qué parte del búfer de fotogramas se va a escalar para ajustarse al rectángulo de destino.
-
MCI_DGV_PUT_VIDEO
-
El rectángulo definido para MCI_DGV_RECT se aplica al rectángulo de vídeo. El rectángulo de vídeo especifica qué parte del origen de presentación actual se almacena en el búfer de fotogramas. El rectángulo se especifica utilizando las coordenadas naturales del origen de presentación. Permite la especificación de recorte que se produce antes de almacenar imágenes y vídeo en el búfer de fotogramas. El rectángulo predeterminado es el área de examen activa completa o las imágenes y vídeos descomprimidos completos.
-
MCI_DGV_PUT_WINDOW
-
El rectángulo definido para MCI_DGV_RECT se aplica a la ventana de presentación. Este rectángulo es relativo a la ventana primaria de la ventana de presentación (normalmente el escritorio). Si no se especifica la ventana, el valor predeterminado es el tamaño y la posición iniciales de la ventana.
-
MCI_DGV_RECT
-
El miembro rc de la estructura identificada por lpDest contiene un rectángulo válido.
En el caso de los dispositivos de vídeo digital, lpDest apunta a una estructura de MCI_DGV_PUT_PARMS .
Las marcas adicionales siguientes se usan con el tipo de dispositivo de superposición :
-
MCI_OVLY_PUT_DESTINATION
-
El rectángulo definido para MCI_OVLY_RECT especifica el área de la ventana de cliente utilizada para mostrar una imagen. El rectángulo contiene el desplazamiento y la extensión visible de la imagen en relación con el origen de la ventana. Si el marco se está estirando, el origen se extiende al rectángulo de destino.
-
MCI_OVLY_PUT_FRAME
-
El rectángulo definido para MCI_OVLY_RECT especifica el área del búfer de vídeo usado para recibir la imagen de vídeo. El rectángulo contiene el desplazamiento y la extensión del área de búfer en relación con el origen del búfer de vídeo.
-
MCI_OVLY_PUT_SOURCE
-
El rectángulo definido para MCI_OVLY_RECT especifica el área del búfer de vídeo utilizado como origen de la imagen digital. El rectángulo contiene el desplazamiento y la extensión del rectángulo de recorte para el búfer de vídeo en relación con su origen.
-
MCI_OVLY_PUT_VIDEO
-
El rectángulo definido para MCI_OVLY_RECT especifica el área de la captura de origen de vídeo por el búfer de vídeo. El rectángulo contiene el desplazamiento y la extensión del rectángulo de recorte para el origen del vídeo en relación con su origen.
-
MCI_OVLY_RECT
-
El miembro rc de la estructura identificada por lpDest contiene un rectángulo de visualización válido. Si no se especifica esta marca, el rectángulo predeterminado coincide con las coordenadas del búfer de vídeo o la ventana que se recorta.
En el caso de los dispositivos de superposición de vídeo, lpDest apunta a una estructura de MCI_OVLY_RECT_PARMS .
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] |
| Encabezado |
|