Ler em inglês

Compartilhar via


comando update

O comando update repinta o quadro atual no DC (contexto do dispositivo) especificado. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

_stprintf_s(
  lpszCommand, 
  TEXT("update %s %s %s"), 
  lpszDeviceID, 
  lpszHDC, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszHDC

Identificador de um DC. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando de atualização e os sinalizadores usados por cada tipo.

Valor Significado Significado
digitalvideo hdc hdchdc hdc em rect hdc de pintura hdc

A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszHDC e seus significados.

Valor Significado
hdc hdc Especifica o identificador do DC a ser pintado.
hdc hdc em rect Especifica o retângulo de recorte relativo ao retângulo do cliente.
hdc de pintura hdc Pinta o DC quando o aplicativo recebe uma mensagem WM_PAINT destinada a um DC.

Para especificar o identificador do DC, use a cadeia de caracteres "hdc" seguida por uma representação ASCII do identificador. O retângulo é especificado comoX1 Y1 X2 Y2. As coordenadasX1 Y1especificam o canto superior esquerdo do retângulo e as coordenadasX2 Y2especificam a largura e a altura.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital, o "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retorna zero se tiver êxito ou um erro de outra forma.

Exemplos

O comando a seguir atualiza toda a janela de exibição usada pelo dispositivo "movie". O número 203 é um identificador para um DC obtido da função BeginPaint .

update movie hdc 203

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

MCI

Cadeias de caracteres de comando MCI