Método IMXF::P utMessage (dmusicks.h)

O método PutMessage passa uma estrutura de DMUS_KERNEL_EVENT para seu próximo destino. O driver de miniporto usa esse método para descartar estruturas de eventos usadas para que possam ser recicladas pelo alocador.

Syntax

Sintaxe

NTSTATUS PutMessage(
  PDMUS_KERNEL_EVENT pDMKEvt
);

Parâmetros

pDMKEvt

Ponteiro para a estrutura de DMUS_KERNEL_EVENT que está sendo passada para seu destino.

Retornar valor

Esse método retorna NTSTATUS que contém STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, o método retorna um código de erro apropriado.

Comentários

Durante a renderização, o driver de miniporto chama o método PutMessage para descartar estruturas de DMUS_KERNEL_EVENT usadas. O método roteia as estruturas descartadas para o alocador para reutilização. O driver de miniporto chama esse método depois de extrair os dados MIDI das estruturas para renderização.

Durante a captura MIDI, esse método é usado para empacotar e passar mensagens MIDI para o coletor de captura do driver de porta DMus, conforme mostrado na figura em Transporte MIDI. Essas mensagens podem ser eventos MIDI únicos, múltiplos ou fragmentários e são empacotadas em estruturas de DMUS_KERNEL_EVENT (que são recuperadas por chamadas IAllocatorMXF::GetMessage).

O alocador é sempre o último destino em qualquer cadeia, portanto, cada estrutura DMUS_KERNEL_EVENT eventualmente será reciclada. Se IMXF::ConnectOutput não tiver sido chamado, PutMessage passará a estrutura para o alocador. Para obter mais informações, consulte Allocator.

Requisitos

Requisito	Valor
Cabeçalho	dmusicks.h
IRQL	DISPATCH_LEVEL

Confira também

IMXF