commande MCI_WHERE
La commande MCI_WHERE obtient le rectangle de découpage pour l’appareil vidéo. Les appareils de vidéo numérique et de superposition vidéo reconnaissent cette commande. Les membres supérieur et gauche du RECT retourné contiennent l’origine du rectangle de découpage, et les membres de droite et inférieur contiennent la largeur et la hauteur du rectangle de découpage. (Il ne s’agit pas de l’utilisation standard des membres droit et inférieur .)
Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_WHERE,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpQuery
);
Paramètres
-
wDeviceID
-
Identificateur d’appareil de l’appareil MCI qui doit recevoir le message de commande.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT ou, pour les appareils vidéo numériques, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.
-
lpQuery
-
Pointeur vers une structure MCI_GENERIC_PARMS . (Les appareils avec des jeux de commandes étendus peuvent remplacer cette structure par une structure spécifique à l’appareil.)
Valeur renvoyée
Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.
Notes
Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil digitalvideo :
-
MCI_DGV_WHERE_DESTINATION
-
Obtient une description de la région rectangulaire utilisée pour afficher la vidéo et les images dans la zone cliente de la fenêtre active.
-
MCI_DGV_WHERE_FRAME
-
Obtient une description de la région rectangulaire de la mémoire tampon de trame dans laquelle les images du rectangle vidéo sont mises à l’échelle. Les coordonnées du rectangle sont placées dans le membre rc de la structure identifiée par lpQuery.
-
MCI_DGV_WHERE_MAX
-
Lorsqu’il est utilisé avec MCI_DGV_WHERE_DESTINATION ou MCI_DGV_WHERE_SOURCE, le rectangle retourné indique la largeur et la hauteur maximales de la région spécifiée. Lorsqu’il est utilisé avec MCI_DGV_WHERE_WINDOW, le rectangle retourné indique la taille de l’affichage entier.
-
MCI_DGV_WHERE_SOURCE
-
Obtient une description de la région rectangulaire (rognée à partir de la mémoire tampon d’image) qui est étirée pour s’adapter au rectangle de destination sur l’affichage.
-
MCI_DGV_WHERE_VIDEO
-
Obtient une description de la région rectangulaire rognée à partir de la source de présentation pour remplir le rectangle de cadre dans la mémoire tampon du cadre. Les coordonnées du rectangle sont placées dans le membre rc de la structure identifiée par lpQuery.
-
MCI_DGV_WHERE_WINDOW
-
Obtient une description du cadre de la fenêtre d’affichage.
Pour les appareils vidéo numériques, le paramètre lpQuery pointe vers une structure MCI_DGV_WHERE_PARMS . La structure MCI_DGV_WHERE_PARMS est identique à la structure MCI_DGV_RECT_PARMS .
Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil de superposition :
-
MCI_OVLY_WHERE_DESTINATION
-
Obtient le rectangle d’affichage de destination. Les coordonnées du rectangle sont placées dans le membre rc de la structure identifiée par lpQuery.
-
MCI_OVLY_WHERE_FRAME
-
Obtient le rectangle de cadre de superposition. Les coordonnées du rectangle sont placées dans le membre rc de la structure identifiée par lpQuery.
-
MCI_OVLY_WHERE_SOURCE
-
Obtient le rectangle source. Les coordonnées du rectangle sont placées dans le membre rc de la structure identifiée par lpQuery.
-
MCI_OVLY_WHERE_VIDEO
-
Obtient le rectangle vidéo. Les coordonnées du rectangle sont placées dans le membre rc de la structure identifiée par lpQuery.
Pour les appareils de superposition vidéo, le paramètre lpQuery pointe vers une structure MCI_OVLY_RECT_PARMS .
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] |
| En-tête |
|