Méthode IMXF ::P utMessage (dmusicks.h)
La méthode PutMessage transmet une structure DMUS_KERNEL_EVENT à sa destination suivante. Le pilote miniport utilise cette méthode pour ignorer les structures d’événements utilisées afin qu’elles puissent être recyclées par l’allocateur.
Syntax
Syntaxe
NTSTATUS PutMessage(
PDMUS_KERNEL_EVENT pDMKEvt
);
Paramètres
pDMKEvt
Pointeur vers la structure DMUS_KERNEL_EVENT passée à sa destination.
Valeur retournée
Cette méthode retourne NTSTATUS qui contient STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.
Remarques
Pendant le rendu, le pilote miniport appelle la méthode PutMessage pour ignorer les structures utilisées DMUS_KERNEL_EVENT. La méthode achemine les structures ignorées vers l’allocateur à des fins de réutilisation. Le pilote miniport appelle cette méthode une fois qu’il a extrait les données MIDI des structures pour le rendu.
Lors de la capture MIDI, cette méthode est utilisée pour empaqueter et transmettre des messages MIDI au récepteur de capture du pilote de port DMus, comme illustré dans la figure dans Le transport MIDI. Ces messages peuvent être des événements MIDI uniques, multiples ou fragmentaires et sont empaquetés dans des structures DMUS_KERNEL_EVENT (qui sont récupérées par des appels IAllocatorMXF ::GetMessage).
L’allocateur étant toujours la dernière destination de toute chaîne, chaque structure DMUS_KERNEL_EVENT sera finalement recyclée. Si IMXF ::ConnectOutput n’a pas été appelé, PutMessage passera par défaut la structure à l’allocateur. Pour plus d’informations, consultez Allocator.
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | dmusicks.h |
IRQL | DISPATCH_LEVEL |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour