commande MCI_PUT

La commande MCI_PUT définit les rectangles source, de destination et de cadre. Les appareils de vidéo numérique et de superposition vidéo reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

Paramètres

wDeviceID

Identificateur de l’appareil MCI devant 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 Indicateurs d’attente, de notification et de test.

lpDest

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 une erreur dans le cas contraire.

Notes

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil digitalvideo :

MCI_DGV_PUT_CLIENT

Le rectangle défini pour MCI_DGV_RECT s’applique à la position de la fenêtre cliente. Le rectangle spécifié est relatif à la fenêtre parente de la fenêtre d’affichage. MCI_DGV_PUT_WINDOW doit être défini simultanément avec cet indicateur.

MCI_DGV_PUT_DESTINATION

Le rectangle défini pour MCI_DGV_RECT spécifie un rectangle de destination. Le rectangle de destination spécifie la partie de la fenêtre cliente associée à ce pilote de périphérique instance qui affiche l’image ou la vidéo.

MCI_DGV_PUT_FRAME

Le rectangle défini pour MCI_DGV_RECT s’applique au rectangle de cadre. Le rectangle d’image spécifie la partie de la mémoire tampon de trame utilisée comme destination des images vidéo obtenues à partir du rectangle vidéo. La vidéo doit être mise à l’échelle pour tenir dans le rectangle de la mémoire tampon de trame.

Le rectangle est spécifié dans les coordonnées de la mémoire tampon de trame. Le rectangle par défaut est la mémoire tampon plein cadre. La spécification de ce rectangle permet à l’appareil de mettre à l’échelle l’image à mesure qu’il numérise les données. Les appareils qui ne peuvent pas mettre à l’échelle l’image rejettent cette commande avec MCIERR_UNSUPPORTED_FUNCTION. Vous pouvez utiliser l’indicateur MCI_GETDEVCAPS_CAN_STRETCH avec la commande MCI_GETDEVCAPS pour déterminer si un appareil met à l’échelle l’image. Un appareil retourne FALSE s’il ne peut pas mettre à l’échelle l’image.

MCI_DGV_PUT_SOURCE

Le rectangle défini pour MCI_DGV_RECT spécifie un rectangle source. Le rectangle source spécifie la partie de la mémoire tampon de trame qui doit être mise à l’échelle pour tenir dans le rectangle de destination.

MCI_DGV_PUT_VIDEO

Le rectangle défini pour MCI_DGV_RECT s’applique au rectangle vidéo. Le rectangle vidéo spécifie quelle partie de la source de présentation actuelle est stockée dans la mémoire tampon d’images. Le rectangle est spécifié à l’aide des coordonnées naturelles de la source de présentation. Il permet la spécification du rognage qui se produit avant le stockage des images et des vidéos dans la mémoire tampon d’images. Le rectangle par défaut est la zone d’analyse active complète ou les images et la vidéo décompressées complètes.

MCI_DGV_PUT_WINDOW

Le rectangle défini pour MCI_DGV_RECT s’applique à la fenêtre d’affichage. Ce rectangle est relatif à la fenêtre parente de la fenêtre d’affichage (généralement le bureau). Si la fenêtre n’est pas spécifiée, elle prend par défaut la taille et la position initiales de la fenêtre.

MCI_DGV_RECT

Le membre rc de la structure identifiée par lpDest contient un rectangle valide.

Pour les appareils vidéo numériques, lpDest pointe vers une structure MCI_DGV_PUT_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil de superposition :

MCI_OVLY_PUT_DESTINATION

Le rectangle défini pour MCI_OVLY_RECT spécifie la zone de la fenêtre cliente utilisée pour afficher une image. Le rectangle contient le décalage et l’étendue visible de l’image par rapport à l’origine de la fenêtre. Si le cadre est étiré, la source est étendue au rectangle de destination.

MCI_OVLY_PUT_FRAME

Le rectangle défini pour MCI_OVLY_RECT spécifie la zone de la mémoire tampon vidéo utilisée pour recevoir l’image vidéo. Le rectangle contient le décalage et l’étendue de la zone de mémoire tampon par rapport à l’origine de la mémoire tampon vidéo.

MCI_OVLY_PUT_SOURCE

Le rectangle défini pour MCI_OVLY_RECT spécifie la zone de la mémoire tampon vidéo utilisée comme source de l’image numérique. Le rectangle contient le décalage et l’étendue du rectangle de découpage pour la mémoire tampon vidéo par rapport à son origine.

MCI_OVLY_PUT_VIDEO

Le rectangle défini pour MCI_OVLY_RECT spécifie la zone de la capture de la source vidéo par la mémoire tampon vidéo. Le rectangle contient le décalage et l’étendue du rectangle de découpage de la source vidéo par rapport à son origine.

MCI_OVLY_RECT

Le membre rc de la structure identifiée par lpDest contient un rectangle d’affichage valide. Si cet indicateur n’est pas spécifié, le rectangle par défaut correspond aux coordonnées de la mémoire tampon vidéo ou de la fenêtre en cours de découpage.

Pour les appareils de superposition vidéo, lpDest 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	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI