Share via


commande réaliser

La commande réaliser indique à un appareil de sélectionner et de réaliser sa palette dans le contexte d’affichage de la fenêtre affichée. 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("realize %s %s %s"), 
  lpszDeviceID, 
  lpszPalette, 
  lpszFlags
); 

Paramètres

lpszDeviceID

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

lpszPalette

L’un des indicateurs suivants.

Valeur Signification
background Réalise la palette en tant que palette d’arrière-plan.
normal Réalise la palette d’une fenêtre de niveau supérieur. Il s'agit du paramètre par défaut.

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.

Notes

Utilisez cette commande uniquement si votre application utilise un handle de fenêtre et reçoit un message WM_QUERYNEWPALLETTE ou WM_PALETTECHANGED .

Exemples

La commande suivante indique à l’appareil « myvideo » de réaliser sa palette.

realize myvideo normal

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