IAllocatorMXF::GetMessage-Methode (dmusicks.h)

Artikel
02/26/2024

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.