IAllocatorMXF ::GetMessage, méthode (dmusicks.h)
La méthode GetMessage sert de point de récupération pour n’importe quel composant en mode noyau DirectMusic qui utilise l’allocateur du pilote de port pour réutiliser les structures DMUS_KERNEL_EVENT.
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 dans 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 de retour
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 GetMessage pour récupérer des structures d’événements pour le rendu et la capture MIDI. Cette méthode récupère des structures DMUS_KERNEL_EVENT à partir du même pool que IMXF ::P utMessage les place lorsqu’elle les ignore à 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 vous y êtes invité par le DPC de service habituel.
Pour plus d’informations sur l’allocateur, consultez allocator.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | dmusicks.h (include Dmusicks.h) |
| IRQL | <=DISPATCH_LEVEL |