commande where

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