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 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 |