IMXF::P utMessage-Methode (dmusicks.h)
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 das Ziel übergeben wird.
Rückgabewert
Diese Methode gibt NTSTATUS zurück, die STATUS_SUCCESS enthält, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.
Bemerkungen
Während des Renderns ruft der Miniporttreiber die PutMessage-Methode auf, um verwendete DMUS_KERNEL_EVENT Strukturen zu verwerfen. Die Methode leitet die verworfenen Strukturen zur Wiederverwendung an den Allocator weiter. Der Miniporttreiber ruft diese Methode auf, sobald sie die MIDI-Daten aus den Strukturen zum Rendern extrahiert hat.
Während der MIDI-Aufnahme wird diese Methode verwendet, um MIDI-Nachrichten an die Aufnahmesenke des DMus-Porttreibers zu packen und zu übergeben, wie in der Abbildung im MIDI-Transport gezeigt. Diese Nachrichten können einzelne, mehrere oder fragmentäre MIDI-Ereignisse sein und in DMUS_KERNEL_EVENT Strukturen verpackt werden (die von IAllocatorMXF::GetMessage-Aufrufen abgerufen werden).
Der Allocator ist immer das letzte Ziel in jeder Kette, sodass jede DMUS_KERNEL_EVENT Struktur schließlich wiederverwendet wird. Wenn IMXF::ConnectOutput nicht aufgerufen wurde, übergibt PutMessage standardmäßig die Struktur an den Allocator. Weitere Informationen finden Sie unter Allocator.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dmusicks.h |
| IRQL- | DISPATCH_LEVEL |