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

Voir aussi

MCI

Commandes MCI