comando update

Articolo
06/13/2023

Il comando update aggiorna il frame corrente nel contesto di dispositivo specificato. I dispositivi digital-video riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

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

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato all'apertura del dispositivo.

lpszHDC

Handle di un controller di dominio. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando di aggiornamento e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	hdc hdc hdchdc in rect	paint hdc hdc

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszHDC e i relativi significati.

Valore	Significato
hdc hdc	Specifica l'handle del controller di dominio da disegnare.
hdc hdc in rect	Specifica il rettangolo di ritaglio relativo al rettangolo client.
paint hdc hdc	Disegna il controller di dominio quando l'applicazione riceve un messaggio di WM_PAINT destinato a un controller di dominio.

Per specificare l'handle del controller di dominio, usare la stringa "hdc" seguita da una rappresentazione ASCII dell'handle. Il rettangolo viene specificato comeX1 Y1 X2 Y2. Le coordinateX1 Y1specificano l'angolo superiore sinistro del rettangolo e le coordinateX2 Y2specificano la larghezza e l'altezza.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Flag di attesa, notifica e test.

Valore restituito

Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.

Esempio

Il comando seguente aggiorna l'intera finestra di visualizzazione usata dal dispositivo "movie". Il numero 203 è un handle per un controller di dominio ottenuto dalla funzione BeginPaint .

update movie hdc 203

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI
Stringhe di comando MCI