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 |