comando MCI_SETVIDEO

El comando MCI_SETVIDEO establece los valores asociados a la reproducción de vídeo. Los dispositivos de vídeo digital y VCR reconocen este comando.

Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.

lpSetVideo

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.

Comentarios

Las siguientes marcas adicionales se usan con el tipo de dispositivo "digitalvideo":

MCI_DGV_SETVIDEO_ALG

El miembro lpstrAlgorithm de la estructura identificada por lpSetVideo contiene una dirección de un búfer que contiene el nombre de un algoritmo de compresión de vídeo. El algoritmo de compresión lo usan los comandos siguientes MCI_RESERVE o MCI_RECORD . Los algoritmos disponibles dependen del dispositivo.

Si el algoritmo especificado no es compatible con el formato de archivo actual, el formato de archivo se cambia al formato predeterminado para el algoritmo.

MCI_DGV_SETVIDEO_CLOCKTIME

Cuando se usa con MCI_DGV_SETVIDEO_OVER, indica que el tiempo se especifica en milisegundos y es el tiempo absoluto. (Esta vez no está en paso con la reproducción del área de trabajo).

MCI_DGV_SETVIDEO_INPUT

Modifica el MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS o MCI_DGV_SETVIDEO_TINT para que afecte a la señal de entrada y modifique lo que se registra. Si es posible, este es el valor predeterminado al supervisar la entrada.

MCI_DGV_SETVIDEO_ITEM

Se especifica una constante de vídeo en el miembro dwItem de la estructura identificada por lpSetVideo. La constante identifica el valor que se va a establecer. Puede especificar las siguientes constantes con esta marca:

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

Se especifica una nueva dirección de procedimiento de dibujo en el miembro dwValue de la estructura identificada por lpSetVideo. Puede especificar un nuevo procedimiento de dibujo solo cuando el dispositivo está inactivo. Este indicador solo lo reconoce el controlador mciavi digital-video. No hay ningún equivalente a esta marca en la interfaz de comandos de cadena.

MCI_AVI_SETVIDEO_PALETTE_COLOR

Se especifica un nuevo color de paleta en los miembros dwOver y dwValue de la estructura identificada por lpSetVideo. El miembro dwOver especifica el índice de paleta del color que se va a cambiar y el miembro dwValue especifica el nuevo color, como un valor RGB. También debe especificar las marcas MCI_DGV_SETVIDEO_OVER y MCI_DGV_SETVIDEO_VALUE con MCI_DGV_SETVIDEO_ITEM cuando use esta constante. Este indicador solo lo reconoce el controlador mciavi digital-video.

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

Indica que se debe usar la paleta de tonos medio, en lugar de la paleta predeterminada. Este indicador solo lo reconoce el controlador mciavi digital-video.

MCI_DGV_SETVIDEO_BITSPERPEL

El número de bits por píxel se especifica en el miembro dwValue de la estructura identificada por lpSetVideo. El número de bits por píxel se usa para guardar datos capturados o registrados.

MCI_DGV_SETVIDEO_BRIGHTNESS

El nivel de brillo de vídeo se especifica como un factor en el miembro dwValue de la estructura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_COLOR

El nivel de saturación de color de vídeo se especifica como un factor en el miembro dwValue de la estructura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_CONTRAST

El nivel de contraste de vídeo se especifica como un factor en el miembro dwValue de la estructura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_FRAME_RATE

Se especifica una velocidad de fotogramas en el miembro dwValue de la estructura identificada por lpSetVideo. La velocidad se especifica en unidades de fotogramas por segundo veces 1000. Por ejemplo, se especifican 29,97 fotogramas por segundo como 29970.

MCI_DGV_SETVIDEO_GAMMA

Se especifica un valor exponente de corrección gamma en el miembro dwValue de la estructura identificada por lpSetVideo. La corrección gamma ajusta la asignación entre la intensidad codificada en la fuente de presentación y el brillo mostrado. El valor es el exponente multiplicado por 1000. Por ejemplo, 2200 indica un exponente de 2.2. Un valor de 1000 indica un exponente de 1, que no aplica ninguna corrección gamma.

MCI_DGV_SETVIDEO_KEY_COLOR

Se especifica un color de clave en el miembro dwValue de la estructura identificada por lpSetVideo. El color de clave es un valor RGB.

MCI_DGV_SETVIDEO_KEY_INDEX

Se especifica un valor de índice de clave en el miembro dwValue de la estructura identificada por lpSetVideo. El parámetro index es un índice de paleta física.

MCI_DGV_SETVIDEO_PALHANDLE

Se especifica un identificador de paleta en el miembro dwValue de la estructura identificada por lpSetVideo. El identificador de paleta se encuentra en la palabra de orden bajo. Los dispositivos de vídeo digital no deben liberar la paleta pasada con este comando. Las aplicaciones deben liberarla después de cerrar el dispositivo. Esta marca solo es compatible con dispositivos que usan paletas. Si este identificador de paleta especificado es cero, se usa la paleta predeterminada.

MCI_DGV_SETVIDEO_SHARPNESS

Se especifica un valor de nitidez de vídeo como factor en el miembro dwValue de la estructura identificada por lpSetVideo.

MCI_DGV_SETVIDEO_SOURCE

Una constante que especifica el origen de la entrada de vídeo se especifica en el miembro dwValue de la estructura identificada por lpSetVideo. Se definen las siguientes constantes:

• MCI_DGV_SETVIDEO_SRC_NTSC: televisión NTSC.
• MCI_DGV_SETVIDEO_SRC_PAL: televisión PAL.
• MCI_DGV_SETVIDEO_SRC_RGB: vídeo RGB.
• MCI_DGV_SETVIDEO_SRC_SECAM: TELEVISIÓN SECAM.
• MCI_DGV_SETVIDEO_SRC_SVIDEO: S-Video.

MCI_DGV_SETVIDEO_STREAM

Se especifica una secuencia de vídeo en el miembro dwValue de la estructura identificada por lpSetVideo. El valor entero especifica la secuencia de vídeo reproducida desde el área de trabajo. Si no se especifica la secuencia y el formato de archivo no define una secuencia predeterminada, se reproduce la primera secuencia de vídeo intercalada físicamente.

MCI_DGV_SETVIDEO_TINT

Un valor de tono de vídeo se especifica como un factor en el miembro dwValue de la estructura identificada por lpSetVideo. Normalmente, este ajuste se modela después del control de tono de muchos televisores de color, con 250 definidos como verde, 750 definidos como rojo y 0 (o 1000) definidos como azul. El valor nominal siempre es 500.

MCI_DGV_SETVIDEO_OUTPUT

La marca MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS o MCI_DGV_SETVIDEO_TINT se modifica para que afecte solo a la señal mostrada y no a lo que se registra. Si es posible, este es el valor predeterminado al supervisar un archivo.

MCI_DGV_SETVIDEO_OVER

Se incluye un parámetro de longitud de transición en el miembro dwOver de la estructura identificada por lpSetVideo. La longitud de la transición especifica cuánto tiempo (en el formato de hora actual) se debe tardar en realizar un cambio. Si no se usa esta marca, el cambio se produce inmediatamente.

MCI_DGV_SETVIDEO_QUALITY

El miembro lpstrQuality de la estructura identificada por lpSetVideo contiene una dirección de un búfer que describe la calidad del vídeo. Una cadena de texto en el búfer especifica las características del algoritmo de compresión de vídeo.

La marca MCI_DGV_SETVIDEO_ALG se puede usar para seleccionar un descriptor de calidad para el algoritmo especificado. Si se omite esta marca, se usa el algoritmo actual.

Los algoritmos y los nombres de descriptor disponibles dependen del dispositivo. Cada dispositivo proporciona documentación para los algoritmos disponibles y una descripción de los nombres de descriptor aplicables. El comando MCI_QUALITY puede definir nombres de descriptor adicionales. Todos los dispositivos admiten los descriptores "low", "medium" y "high". El valor predeterminado es específico del controlador.

MCI_DGV_SETVIDEO_RECORD

Especifica si la grabación incluye o excluye los datos de vídeo. Cuando se combina con MCI_SET_ON, se graban los datos de vídeo. Cuando se combina con MCI_SET_OFF, se excluyen los datos de vídeo. El valor predeterminado incluye datos de vídeo.

MCI_DGV_SETVIDEO_SRC_NUMBER

Se especifica un número para el origen de vídeo en el miembro dwSourceNumber de la estructura identificada por lpSetVideo. Si hay más de una entrada del tipo especificado por MCI_DGV_SETVIDEO_VALUE, el valor selecciona la entrada. Esta marca siempre debe usarse con MCI_DGV_SETVIDEO_SOURCE. Sin embargo, si MCI_DGV_SETVIDEO_VALUE se omite, el número de origen especificado indica el origen absoluto que se va a usar como se especifica en el comando MCI_LIST .

MCI_DGV_SETVIDEO_STILL

El nombre del algoritmo o el valor de calidad especificado se aplica a las imágenes fijas.

Cada controlador de dispositivo debe admitir un algoritmo de "none", lo que significa que no hay compresión. Este es el valor predeterminado. En este caso, los dispositivos de vídeo digital guardan imágenes fijas como mapas de bits independientes del dispositivo RGB (DIB).

MCI_DGV_SETVIDEO_VALUE

Un valor se incluye en el miembro dwValue de la estructura identificada por lpSetVideo. El significado del valor se especifica mediante la marca MCI_DGV_SETVIDEO_ITEM .

MCI_SET_OFF

Deshabilita la salida de vídeo. En el caso de los dispositivos de vídeo digital, al deshabilitar el vídeo se establecen los píxeles del rectángulo de destino definido por el comando MCI_PUT (o su valor predeterminado, la región de cliente de la ventana actual) en un color sólido, pero no tiene ningún efecto en el búfer de fotogramas. Si lo desea, puede ocultar la ventana con el comando MCI_WINDOW . El origen del vídeo, ya sea el área de trabajo o una entrada externa, puede seguir almacenando nuevas imágenes en el búfer de fotogramas, pero no se muestran hasta que se habilite el vídeo. Aunque las aplicaciones deben usar el comando MCI_SETVIDEO para controlar esta función, los dispositivos de vídeo digital deben seguir admitiendo esta marca. El valor predeterminado después de abrir está activado.

MCI_SET_ON

Habilita la salida de vídeo.

En el caso de los dispositivos de vídeo digital, el parámetro lpSetVideo apunta a una estructura de MCI_DGV_SETVIDEO_PARMS .

Las marcas adicionales siguientes se usan con el tipo de dispositivo "vcr":

MCI_VCR_SETVIDEO_RECORD

Establece la grabación de vídeo en activado o desactivado. Se usa junto con una de las marcas siguientes:

• MCI_SET_ON. Grabación de vídeo en.
• MCI_SET_OFF. Grabación de vídeo desactivada. Es posible que sea necesario desactivar primero la grabación de ensamblado (mediante el comando MCI_SET con la marca MCI_VCR_SET_ASSEMBLE_RECORD establecida en desactivado) antes de que se pueda desactivar la grabación de vídeo.

MCI_TRACK

El miembro dwTrack de la estructura identificada por lpSetVideo especifica qué pista se ve afectada por el comando.

MCI_VCR_SETVIDEO_SOURCE

Establece el origen del vídeo y se debe usar con la marca MCI_VCR_SETVIDEO_TO .

MCI_VCR_SETVIDEO_MONITOR

Establece el monitor de origen de vídeo y debe usarse con la marca MCI_VCR_SETVIDEO_TO.

MCI_VCR_SETVIDEO_TO

El miembro dwTo de la estructura identificada por lpSetVideo contiene una de las siguientes constantes:

**MCI\_VCR\_SRC\_TYPE\_TUNER**

**MCI\_VCR\_SRC\_TYPE\_LINE**

**MCI\_VCR\_SRC\_TYPE\_AUX**

**MCI\_VCR\_SRC\_TYPE\_GENERIC**

**MCI\_VCR\_SRC\_TYPE\_MUTE**

**MCI\_VCR\_SRC\_TYPE\_OUTPUT**

**MCI\_VCR\_SRC\_TYPE\_RGB**

**MCI\_VCR\_SETVIDEO\_NUMBER**

El miembro dwNumber de la estructura identificada por lpSetVideo contiene la entrada de vídeo (del tipo especificado en el miembro dwTo ) que se va a usar.

En el caso de los dispositivos VCR, el parámetro lpSetVideo apunta a una estructura de MCI_VCR_SETVIDEO_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	Mmsystem.h (incluye Windows.h)

Consulte también

MCI

Comandos de MCI