Metodo IMXF::P utMessage (dmusicks.h)
Il metodo PutMessage passa una struttura DMUS_KERNEL_EVENT alla destinazione successiva. Il driver miniport usa questo metodo per eliminare le strutture evento usate in modo che possano essere riciclate dall'allocatore.
Sintassi
Sintassi
NTSTATUS PutMessage(
PDMUS_KERNEL_EVENT pDMKEvt
);
Parametri
pDMKEvt
Puntatore alla struttura DMUS_KERNEL_EVENT passata alla destinazione.
Valore restituito
Questo metodo restituisce NTSTATUS che contiene STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.
Osservazioni
Durante il rendering, il driver miniport chiama il metodo PutMessage per eliminare le strutture usate DMUS_KERNEL_EVENT. Il metodo indirizza le strutture eliminate all'allocatore per il riutilizzo. Il driver miniport chiama questo metodo dopo aver estratto i dati MIDI dalle strutture per il rendering.
Durante l'acquisizione MIDI, questo metodo viene utilizzato per creare pacchetti e passare messaggi MIDI al sink di acquisizione del driver di porta DMus, come illustrato nella figura in MIDI Transport. Questi messaggi possono essere eventi MIDI singoli, multipli o frammentati e vengono inseriti in un pacchetto in strutture DMUS_KERNEL_EVENT (recuperate dalle chiamate IAllocatorMXF::GetMessage).
L'allocatore è sempre l'ultima destinazione in qualsiasi catena, quindi ogni DMUS_KERNEL_EVENT struttura verrà infine riciclata. Se IMXF::ConnectOutput non è stato chiamato, Per impostazione predefinita PutMessage passerà la struttura all'allocatore. Per altre informazioni, vedere Allocatore.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | dmusicks.h |
| IRQL | DISPATCH_LEVEL |