IAllocatorMXF::GetMessage-Methode (dmusicks.h)
Die GetMessage -Methode dient als Abrufpunkt für jede DirectMusic-Kernelmoduskomponente, die die Zuweisung des Porttreibers verwendet, um DMUS_KERNEL_EVENT-Strukturen wiederzuverwenden.
Syntax
NTSTATUS GetMessage(
[out] PDMUS_KERNEL_EVENT *ppDMKEvt
);
Parameter
[out] ppDMKEvt
Ausgabezeiger für das MIDI-Ereignis. Dieser Parameter verweist auf eine vom Aufrufer zugeordnete Zeigervariable, in die die Methode einen Zeiger auf die Ereignisstruktur schreibt, die vom Zuweisungsgeber abgerufen wird. Die Struktur selbst ist leer (vom Zuweisungszeichen null).
Rückgabewert
GetMessage gibt S_OK zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.
Hinweise
Der Miniporttreiber verwendet die GetMessage -Methode, um Ereignisstrukturen für MIDI-Rendering und -Erfassung abzurufen. Diese Methode ruft DMUS_KERNEL_EVENT Strukturen aus dem gleichen Pool ab, in den IMXF::P utMessage diese einfügt, wenn sie an den Zuweisungsator verworfen werden.
Im Fall eines MIDI-Aufnahmestreams ruft der Porttreiber Aufzeichnungsereignisse vom Miniporttreiber ab, wenn er vom üblichen Dienst-DPC aufgefordert wird.
Weitere Informationen zum Allocator finden Sie unter Allocator.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dmusicks.h (einschließlich Dmusicks.h) |
| IRQL | <=DISPATCH_LEVEL |