_Message d’ouverture ACM

Ouvre un clip AVI et affiche sa première image dans un contrôle d’animation. Vous pouvez envoyer ce message de manière explicite ou utiliser la macro animer _ ouvrir ou animer _ OpenEx . Nous vous recommandons d’utiliser la version Unicode de ce message, ACM _ OPENW.

Paramètres

wParam

Version 4,71 et versions ultérieures. Handle d’instance du module à partir duquel la ressource doit être chargée. Définissez cette valeur sur null pour que le contrôle utilise la valeur HINSTANCE utilisée pour créer la fenêtre. Notez que si la fenêtre est créée par une DLL, la valeur par défaut de wParam est la valeur HINSTANCE de la dll, et non celle de l’application qui appelle la dll.

lParam

Pointeur vers une mémoire tampon qui contient le chemin d’accès du fichier AVI ou le nom d’une ressource AVI. Ce paramètre peut également être constitué de l’identificateur de ressource AVI dans LOWORD et de zéro dans le HIWORD. Pour créer cette valeur, utilisez la macro MAKEINTRESOURCE . Le contrôle charge la ressource AVI à partir du module spécifié par le handle d’instance passé à la fonction CreateWindow , à la macro de création d' animation _ ou à la fonction de création de boîte de dialogue qui a créé le contrôle. Dans la Version 4,71 et les versions ultérieures, la ressource est chargée à partir du module spécifié par wParam. Une ressource AVI doit avoir le type « AVI ». Si ce paramètre a la valeur null, le système ferme le fichier AVI précédemment ouvert pour le contrôle d’animation spécifié, le cas échéant.

Valeur de retour

Retourne une valeur différente de zéro en cas de réussite, ou zéro dans le cas contraire.

Notes

Le fichier ou la ressource AVI spécifié par lpszName ne doit pas contenir de données audio.

Nous vous recommandons d’utiliser la version Unicode de ce message, ACM _ OPENW.

Vous ne pouvez ouvrir que des clips AVI en mode silencieux. Le composant ACM _ Open et Animate _ Open échoue si lParam spécifie un clip AVI contenant du son.

Vous pouvez utiliser l' animation _ Fermer pour fermer un fichier AVI ou une ressource AVI précédemment ouverte pour le contrôle d’animation spécifié.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Commctrl. h
Noms Unicode et ANSI
ACM _ OPENW (Unicode) et ACM _ Opena (ANSI)