IAllocatorMXF ::GetMessage, méthode (dmusicks.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | dmusicks.h (inclure Dmusicks.h) |
| IRQL | <=DISPATCH_LEVEL |