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

Voir aussi

IMXF