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 strutture eventi 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 esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.

Commenti

Durante il rendering, il driver miniport chiama il metodo PutMessage per eliminare le strutture usate DMUS_KERNEL_EVENT. Il metodo instrada le strutture rimosse 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 usato per creare pacchetti e passare messaggi MIDI al sink di acquisizione del driver di porta DMus, come illustrato nella figura in Trasporto MIDI. Questi messaggi possono essere singoli, multipli o frammentari e vengono inseriti in pacchetti 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, PutMessage verrà predefinito per passare la struttura all'allocatore. Per altre informazioni, vedere Allocator.

Requisiti

Requisito	Valore
Intestazione	dmusicks.h
IRQL	DISPATCH_LEVEL

Vedi anche

IMXF