IAllocatorMXF ::GetMessage, méthode (dmusicks.h)

Article
02/26/2024

La GetMessage méthode sert de point de récupération pour tout composant DirectMusic en mode noyau qui utilise l’allocateur du pilote de port pour réutiliser DMUS_KERNEL_EVENT structures.

Syntaxe

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

Paramètres

[out] ppDMKEvt

Pointeur de sortie pour l’événement MIDI. Ce paramètre pointe vers une variable de pointeur allouée par l’appelant dans laquelle la méthode écrit un pointeur vers la structure d’événements récupérée à partir de l’allocateur. La structure elle-même est vide (zéro par l’allocateur).

Valeur retournée

GetMessage retourne S_OK si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.

Remarques

Le pilote miniport utilise la méthode pour récupérer des GetMessage structures d’événements pour le rendu et la capture MIDI. Cette méthode récupère les structures DMUS_KERNEL_EVENT du même pool dans lequel IMXF ::P utMessage les place lorsqu’elle les abandonne à l’allocateur.

Dans le cas d’un flux de capture MIDI, le pilote de port récupère les événements de capture à partir du pilote miniport lorsque le DPC de service habituel vous y invite.

Pour plus d’informations sur l’allocateur, consultez Allocator.