IMXF ::P utMessage, méthode (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.
Syntaxe
Syntaxe
NTSTATUS PutMessage(
PDMUS_KERNEL_EVENT pDMKEvt
);
Paramètres
pDMKEvt
Pointeur vers la structure DMUS_KERNEL_EVENT passée à sa destination.
Valeur de retour
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 route les structures ignorées vers l’allocateur pour la réutilisation. Le pilote miniport appelle cette méthode une fois qu’elle a extrait les données MIDI des structures pour le rendu.
Pendant 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 est toujours la dernière destination dans n’importe quelle chaîne, de sorte que chaque structure DMUS_KERNEL_EVENT sera finalement recyclée. Si IMXF ::ConnectOutput n’a pas été appelé, PutMessage passe par défaut la structure à l’allocateur. Pour plus d’informations, consultez Allocator.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dmusicks.h |
| IRQL | DISPATCH_LEVEL |