commande update

La commande de mise à jour repeint l’image actuelle dans le contexte d’appareil (DC) spécifié. Les appareils vidéo numériques reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

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

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszHDC

Handle d’un contrôleur de domaine. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande update et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	hdc hdc hdchdc hdc at rect	paint hdc hdc

Le tableau suivant répertorie les indicateurs qui peuvent être spécifiés dans le paramètre lpszHDC et leurs significations.

Valeur	Signification
hdc hdc	Spécifie la poignée du contrôleur de domaine à peindre.
hdc hdc àrect	Spécifie le rectangle de découpage par rapport au rectangle client.
paint hdc hdc	Peint le contrôleur de domaine lorsque l’application reçoit un message WM_PAINT destiné à un contrôleur de domaine.

Pour spécifier le handle du contrôleur de domaine, utilisez la chaîne « hdc » suivie d’une représentation ASCII du handle. Le rectangle est spécifié sous la formeX1 Y1 X2 Y2. Les coordonnéesX1 Y1spécifient le coin supérieur gauche du rectangle, et les coordonnéesX2 Y2spécifient la largeur et la hauteur.

lpszFlags

Peut être « attendre », « notifier » ou les deux. Pour les appareils vidéo numériques, « test » peut également être spécifié. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Exemples

La commande suivante met à jour l’ensemble de la fenêtre d’affichage utilisée par l’appareil « film ». Le nombre 203 est un handle d’un contrôleur de domaine obtenu à partir de la fonction BeginPaint .

update movie hdc 203

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

MCI

Chaînes de commande MCI