IMXF::P utMessage-Methode (dmusicks.h)

  • Artikel

Die PutMessage-Methode übergibt eine DMUS_KERNEL_EVENT-Struktur an das nächste Ziel. Der Miniporttreiber verwendet diese Methode, um verwendete Ereignisstrukturen zu verwerfen, damit sie vom Allocator wiederverwendet werden können.

Syntax

Syntax

NTSTATUS PutMessage(
  PDMUS_KERNEL_EVENT pDMKEvt
);

Parameter

pDMKEvt

Zeiger auf die DMUS_KERNEL_EVENT-Struktur, die an ihr Ziel übergeben wird.

Rückgabewert

Diese Methode gibt NTSTATUS zurück, das STATUS_SUCCESS enthält, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Hinweise

Während des Renderings ruft der Miniporttreiber die PutMessage-Methode auf, um verwendete DMUS_KERNEL_EVENT Strukturen zu verwerfen. Die -Methode leitet die verworfenen Strukturen zur Wiederverwendung an die Zuweisung weiter. Der Miniporttreiber ruft diese Methode auf, sobald er die MIDI-Daten für das Rendern aus den Strukturen extrahiert hat.

Während der MIDI-Aufnahme wird diese Methode verwendet, um MIDI-Nachrichten zu verpacken und an die Aufnahmesenke des DMus-Porttreibers zu übergeben, wie in der Abbildung in MIDI-Transport dargestellt. Diese Meldungen können einzelne, mehrere oder fragmentäre MIDI-Ereignisse sein und in DMUS_KERNEL_EVENT-Strukturen gepackt werden (die von IAllocatorMXF::GetMessage-Aufrufen abgerufen werden).

Die Zuweisung ist immer das letzte Ziel in einer Kette, sodass jede DMUS_KERNEL_EVENT Struktur schließlich wiederverwendet wird. Wenn IMXF::ConnectOutput nicht aufgerufen wurde, übergibt PutMessage standardmäßig die Struktur an die Zuweisung. Weitere Informationen finden Sie unter Allocator.

Anforderungen

Anforderung Wert
Header dmusicks.h
IRQL DISPATCH_LEVEL

Weitere Informationen

IMXF