commande where

Article
06/13/2023

La commande where récupère le rectangle spécifiant la zone source ou de destination. Ce rectangle a été spécifié à l’aide de la commande put . 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("where %s %s %s"), 
  lpszDeviceID, 
  lpszRequestRect, 
  lpszFlags
);

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est affecté à l’ouverture de l’appareil.

lpszRequestRect

Indicateur qui identifie le rectangle dont les dimensions sont récupérées. Le tableau suivant répertorie les types d’appareils qui reconnaissent la commande where et les indicateurs utilisés par chaque type.

Valeur	Signification	Signification
digitalvideo	destinationdestination maxframeframe maxsource	source maxvideovideo maxwindowwindow max
superposition	destinationframe	sourcevideo

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

Valeur	Signification
destination	Récupère le décalage et l’extension de destination. Pour les appareils de superposition vidéo, le rectangle de destination définit la zone de la zone cliente de la fenêtre d’affichage qui affiche les données d’image de la mémoire tampon de trame.
max. destination	Récupère la taille actuelle du rectangle client.
frame	Récupère le décalage et l’étendue du rectangle de mémoire tampon de trame. Le rectangle de la mémoire tampon de trame définit la zone de la mémoire tampon de trame qui reçoit les données vidéo entrantes. Les images du rectangle « vidéo » sont mises à l’échelle dans cette région.
frame max	Retourne la taille maximale de la mémoire tampon de trame.
source	Récupère le décalage et l’étendue de la source. Pour les appareils de superposition vidéo, le rectangle source définit la région de la mémoire tampon de trame qui s’affiche dans la fenêtre de destination. L’appareil utilise ce rectangle pour rogner l’image avant qu’elle ne soit étirée pour s’adapter au rectangle de destination sur l’affichage.
max. source	Récupère la taille maximale de la mémoire tampon de trame.
video	Récupère le décalage et l’étendue du rectangle vidéo. Le rectangle vidéo définit la région des données vidéo entrantes qui sont transférées vers la mémoire tampon de trame.
max. vidéo	Retourne la taille maximale de l’entrée.
window	Récupère la taille et la position actuelles du cadre de la fenêtre d’affichage.
max. fenêtre	Récupère la taille de l’affichage entier.

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 Indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne un rectangle dans le paramètre lpszReturnString de la fonction mciSendString . Le rectangle décrit la zone spécifiée dans le paramètre lpszRequestRect de cette commande. Le rectangle est spécifié sous la forme X1 Y1 X2 Y2. Les coordonnées X1 Y1 spécifient l’angle supérieur gauche du rectangle, et les coordonnées X2 Y2 spécifient la largeur et la hauteur.

Exemples

La commande suivante retourne le rectangle d’affichage de l’appareil « film ».

where movie destination

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
Mettre

Partager via