IAllocatorMXF::GetMessage-Methode (dmusicks.h)

Die GetMessage-Methode dient als Abrufpunkt für jede DirectMusic-Kernelmoduskomponente, die den Porttreiber-Allocator 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 zugewiesene Zeigervariable, in die die Methode einen Zeiger auf die Ereignisstruktur schreibt, die vom Allocator abgerufen wird. Die Struktur selbst ist leer (null vom Allocator).

Rückgabewert

GetMessage gibt S_OK zurück, wenn der Anruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Bemerkungen

Der Miniporttreiber verwendet die GetMessage-Methode, um Ereignisstrukturen für MIDI-Rendering und -Aufnahme abzurufen. Diese Methode ruft DMUS_KERNEL_EVENT Strukturen aus demselben Pool ab, in den IMXF::P utMessage :P utMessage, wenn sie sie an den Allocator verwirft.

Im Falle eines MIDI-Aufnahmedatenstroms ruft der Porttreiber Aufnahmeereignisse vom Miniporttreiber ab, wenn er vom üblichen Service-DPC aufgefordert wird.

Weitere Informationen zum Allocator finden Sie unter Allocator.

Anforderungen

Siehe auch

DMUS_KERNEL_EVENT

IAllocatorMXF-

IMXF::P utMessage-