MCIWndCreateA, fonction (vfw.h)

Article
11/20/2024

La fonction MCIWndCreate inscrit la classe de fenêtre MCIWnd et crée une fenêtre MCIWnd pour l’utilisation des services MCI. MCIWndCreate pouvez également ouvrir un appareil ou un fichier MCI (tel qu’un fichier AVI) et l’associer à la fenêtre MCIWnd.

Syntaxe

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

Paramètres

hwndParent

Gérez la fenêtre parente.

hInstance

Gérez l’instance de module à associer à la fenêtre MCIWnd.

dwStyle

Indicateurs définissant le style de fenêtre. Outre la spécification des styles de fenêtre utilisés avec la fonction CreateWindowEx , vous pouvez spécifier les styles suivants à utiliser avec les fenêtres MCIWnd.

Valeur	Signification
MCIWNDF_NOAUTOSIZEWINDOW	Ne modifie pas les dimensions d’une fenêtre MCIWnd lorsque la taille de l’image change.
MCIWNDF_NOAUTOSIZEMOVIE	Ne modifie pas les dimensions du rectangle de destination lorsqu’une taille de fenêtre MCIWnd change.
MCIWNDF_NOERRORDLG	Empêche l’affichage des erreurs MCI aux utilisateurs.
MCIWNDF_NOMENU	Masque le bouton Menu de l’affichage dans la barre d’outils et empêche les utilisateurs d’accéder à son menu contextuel.
MCIWNDF_NOOPEN	Masque les commandes ouvertes et fermées dans le menu MCIWnd et empêche les utilisateurs d’accéder à ces choix dans le menu contextuel.
MCIWNDF_NOPLAYBAR	Masque la barre d’outils de l’affichage et interdit aux utilisateurs d’y accéder.
MCIWNDF_NOTIFYANSI	Provoque l’utilisation d’une chaîne ANSI au lieu d’une chaîne Unicode lors de la notification de la fenêtre parente du mode appareil. Cet indicateur est utilisé en combinaison avec MCIWNDF_NOTIFYMODE.
MCIWNDF_NOTIFYMODE	Provoque la notification de MCIWnd à la fenêtre parente avec un message MCIWNDM_NOTIFYMODE chaque fois que l’appareil change de mode d’exploitation. Le paramètre lParam de ce message identifie le nouveau mode, tel que MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	MCIWnd avertit la fenêtre parente avec un message MCIWNDM_NOTIFYPOS chaque fois qu’une modification de la position de lecture ou d’enregistrement dans le contenu se produit. Le paramètre lParam de ce message contient la nouvelle position dans le contenu.
MCIWNDF_NOTIFYMEDIA	Provoque l’alerte MCIWnd sur la fenêtre parente avec un message MCIWNDM_NOTIFYMEDIA chaque fois qu’un nouvel appareil est utilisé ou qu’un fichier de données est ouvert ou fermé. Le paramètre lParam de ce message contient un pointeur vers le nouveau nom de fichier.
MCIWNDF_NOTIFYSIZE	Provoque la notification de MCIWnd à la fenêtre parente lorsque la taille de la fenêtre MCIWnd change.
MCIWNDF_NOTIFYERROR	Provoque la notification de MCIWnd à la fenêtre parente lorsqu’une erreur MCI se produit.
MCIWNDF_NOTIFYALL	Entraîne l’utilisation de tous les styles de notification de fenêtre MCIWNDF.
MCIWNDF_RECORD	Ajoute un bouton Enregistrement à la barre d’outils et ajoute une nouvelle commande de fichier au menu si l’appareil MCI dispose d’une fonctionnalité d’enregistrement.
MCIWNDF_SHOWALL	Entraîne l’utilisation de tous les styles MCIWNDF_SHOW.
MCIWNDF_SHOWMODE	Affiche le mode actuel de l’appareil MCI dans la barre de titre de la fenêtre. Pour obtenir la liste des modes d’appareil, consultez la macro MCIWndGetMode.
MCIWNDF_SHOWNAME	Affiche le nom du fichier de données ou d’appareil MCI ouvert dans la barre de titre de la fenêtre MCIWnd.
MCIWNDF_SHOWPOS	Affiche la position actuelle dans le contenu de l’appareil MCI dans la barre de titre de la fenêtre.

szFile

Chaîne terminée par null indiquant le nom d’un appareil ou d’un fichier de données MCI à ouvrir.

Valeur de retour

Retourne le handle dans une fenêtre MCI en cas de réussite ou de zéro dans le cas contraire.

Remarques

Les styles de fenêtre par défaut d’une fenêtre enfant sont WS_CHILD, WS_BORDER et WS_VISIBLE. MCIWndCreate suppose qu’une fenêtre enfant est spécifiée lorsqu’un handle NULL nond’une fenêtre parente est spécifié.

Les styles de fenêtre par défaut d’une fenêtre parente sont WS_OVERLAPPEDWINDOW et WS_VISIBLE. MCIWndCreate suppose qu’une fenêtre parente est spécifiée lorsqu’un handle NULL d’une fenêtre parente est spécifié.

Utilisez le handle de fenêtre retourné par cette fonction pour le handle de fenêtre dans les macros MCIWnd. Si votre application utilise cette fonction, elle n’a pas besoin d’utiliser la fonction MCIWndRegisterClass.

Note

L’en-tête vfw.h définit MCIWndCreate comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	vfw.h
bibliothèque	Vfw32.lib
DLL	Msvfw32.dll

Voir aussi

Partager via