commande window

La commande window contrôle la fenêtre d’affichage. Vous pouvez utiliser cette commande pour modifier les caractéristiques d’affichage de la fenêtre ou fournir une fenêtre de destination que le pilote doit utiliser à la place de la fenêtre d’affichage par défaut. Les appareils de vidéo numérique et de superposition vidéo reconnaissent cette commande.

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

_stprintf_s(
  lpszCommand, 
  TEXT("window %s %s %s"), 
  lpszDeviceID, 
  lpszWindowFlags, 
  lpszFlags
); 

Paramètres

lpszDeviceID

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

lpszWindowFlags

Indicateur de contrôle de la fenêtre d’affichage. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande window et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	handle hwnd state hidestate minimizestate restorestate showshow agrandi	show minimizedshow min noactiveshow nashow noactivateshow normaltext légende
superposition	fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimisstate minimisdstate no actionstate noactivatestate normal	state restorestate showshow maximizedshow minimisdshow min noactiveshow nashow noactivateshow normalstretchtext légende

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

Valeur	Signification
fixe	Désactive l’étirement de l’image.
gérer par défaut	Spécifie que l’appareil doit revenir à la fenêtre d’affichage par défaut créée pendant l’opération d’ouverture . Pour les appareils de superposition vidéo, spécifie que l’appareil doit créer et gérer sa propre fenêtre de destination.
handle hwnd	Spécifie le handle de la fenêtre de destination à utiliser au lieu de la fenêtre par défaut. Le paramètre hwnd contient l’équivalent numérique ASCII du handle de fenêtre retourné par la fonction CreateWindow . Deux instances d’appareil peuvent utiliser le même handle de fenêtre, à condition que chaque instance met à jour les pixels vidéo et image dans la fenêtre comme si l’autre instance n’existait pas. Lorsque la sortie vidéo est désactivée avec setvideo « off », une commande de mise à jour rend le rectangle de destination une couleur unie.
afficher agrandi	Agrandit la fenêtre de destination.
afficher min noactive	Affiche la fenêtre de destination sous forme d’icône.
afficher minimisé	Réduit la fenêtre de destination.
show na	Affiche la fenêtre de destination dans son état actuel ; la fenêtre actuellement active reste active.
afficher noactivate	Affiche la fenêtre de destination dans sa taille et sa position les plus récentes ; la fenêtre actuellement active reste active.
afficher la normale	Active et affiche la fenêtre de destination dans sa taille et sa position d’origine. (Il s’agit de l’indicateur « restauration d’état ».
masquer l’état	Masque la fenêtre de destination.
icône d’état	Affiche la fenêtre de destination sous forme d’icône.
état agrandi	Agrandit la fenêtre de destination.
réduire l’état	Réduit la fenêtre de destination et active la fenêtre de niveau supérieur dans la liste du gestionnaire de fenêtres.
état réduit	Réduit la fenêtre de destination.
état aucune action	Affiche la fenêtre de destination dans son état actuel. La fenêtre actuellement active reste active.
état noactivate	Affiche la fenêtre de destination dans sa taille et son état les plus récents. La fenêtre actuellement active reste active.
état normal	Active et affiche la fenêtre de destination dans sa taille et sa position d’origine.
restauration d’état	Active et affiche la fenêtre de destination dans sa taille et sa position d’origine.
state show	Affiche la fenêtre de destination.
étirement	Active l’étirement de l’image.
légende texte	Spécifie le légende de la fenêtre de destination. Si ce texte contient des vides incorporés, l’ensemble du légende doit être placé entre guillemets. La légende par défaut de la fenêtre par défaut est vide.

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

Les appareils de superposition vidéo créent et affichent généralement une fenêtre lorsqu’ils sont ouverts. Si votre application fournit une fenêtre au pilote, elle est responsable de la gestion des messages envoyés à la fenêtre.

Étant donné que vous pouvez utiliser la commande status pour récupérer le handle de la fenêtre d’affichage du pilote, vous pouvez également utiliser les fonctions standard du gestionnaire de fenêtres (telles que ShowWindow) pour manipuler la fenêtre.

Exemples

La commande suivante affiche et définit les légende pour la fenêtre de lecture « film ».

window movie text "Welcome to the Movies" state show

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

open

play

setvideo

update