Compartir a través de


Comando update

El comando update vuelve a dibujar el marco actual en el contexto de dispositivo (DC) especificado. Los dispositivos de 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("update %s %s %s"), 
  lpszDeviceID, 
  lpszHDC, 
  lpszFlags
); 

Parámetros

lpszDeviceID

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

lpszHDC

Identificador de un controlador de dominio. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando update y las marcas usadas por cada tipo.

Value Significado Significado
digitalvideo hdc hdchdc hdc en rect paint hdc hdc hdc

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

Value Significado
hdc hdc Especifica el identificador del controlador de dominio que se va a pintar.
hdc hdc en rect Especifica el rectángulo de recorte relativo al rectángulo del cliente.
paint hdc hdc hdc Pinta el controlador de dominio cuando la aplicación recibe un mensaje de WM_PAINT destinado a un controlador de dominio.

Para especificar el identificador del controlador de dominio, use la cadena "hdc" seguida de una representación ASCII del identificador. El rectángulo se especifica comoX1 Y1 X2 Y2. Las coordenadasX1 Y1especifican la esquina superior izquierda del rectángulo y las coordenadasX2 Y2especifican el ancho y el alto.

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 de espera, notificación y prueba.

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario.

Ejemplos

El siguiente comando actualiza toda la ventana de visualización usada por el dispositivo "movie". El número 203 es un identificador para un controlador de dominio obtenido de la función BeginPaint .

update movie hdc 203

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