comando MCI_WHERE

El comando MCI_WHERE obtiene el rectángulo de recorte del dispositivo de vídeo. Los dispositivos digitales de vídeo y superposición de vídeo reconocen este comando. Los miembros superior e izquierdo del RECT devuelto contienen el origen del rectángulo de recorte, y los miembros derecho e inferior contienen el ancho y alto del rectángulo de recorte. (Este no es el uso estándar de los miembros derecho e inferior ).

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WHERE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);

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.

lpQuery

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 marcas adicionales siguientes se usan con el tipo de dispositivo digitalvideo :

MCI_DGV_WHERE_DESTINATION

Obtiene una descripción de la región rectangular que se usa para mostrar vídeo e imágenes en el área cliente de la ventana actual.

MCI_DGV_WHERE_FRAME

Obtiene una descripción de la región rectangular del búfer de fotogramas en la que se escalan las imágenes del rectángulo de vídeo. Las coordenadas del rectángulo se colocan en el miembro rc de la estructura identificada por lpQuery.

MCI_DGV_WHERE_MAX

Cuando se usa con MCI_DGV_WHERE_DESTINATION o MCI_DGV_WHERE_SOURCE, el rectángulo devuelto indica el ancho y alto máximos de la región especificada. Cuando se usa con MCI_DGV_WHERE_WINDOW, el rectángulo devuelto indica el tamaño de toda la pantalla.

MCI_DGV_WHERE_SOURCE

Obtiene una descripción de la región rectangular (recortada desde el búfer de fotogramas) que se extiende para ajustarse al rectángulo de destino en la pantalla.

MCI_DGV_WHERE_VIDEO

Obtiene una descripción de la región rectangular recortada desde el origen de presentación para rellenar el rectángulo de marco en el búfer de fotogramas. Las coordenadas del rectángulo se colocan en el miembro rc de la estructura identificada por lpQuery.

MCI_DGV_WHERE_WINDOW

Obtiene una descripción del marco de la ventana para mostrar.

En el caso de los dispositivos de vídeo digital, el parámetro lpQuery apunta a una estructura de MCI_DGV_WHERE_PARMS . La estructura MCI_DGV_WHERE_PARMS es idéntica a la estructura de MCI_DGV_RECT_PARMS .

Las marcas adicionales siguientes se usan con el tipo de dispositivo de superposición :

MCI_OVLY_WHERE_DESTINATION

Obtiene el rectángulo de presentación de destino. Las coordenadas del rectángulo se colocan en el miembro rc de la estructura identificada por lpQuery.

MCI_OVLY_WHERE_FRAME

Obtiene el rectángulo de marco de superposición. Las coordenadas del rectángulo se colocan en el miembro rc de la estructura identificada por lpQuery.

MCI_OVLY_WHERE_SOURCE

Obtiene el rectángulo de origen. Las coordenadas del rectángulo se colocan en el miembro rc de la estructura identificada por lpQuery.

MCI_OVLY_WHERE_VIDEO

Obtiene el rectángulo de vídeo. Las coordenadas del rectángulo se colocan en el miembro rc de la estructura identificada por lpQuery.

En el caso de los dispositivos de superposición de vídeo, el parámetro lpQuery 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	Mmsystem.h (incluye Windows.h)

Consulte también

MCI

Comandos de MCI