Método IMXF::P utMessage (dmusicks.h)
El método PutMessage pasa una estructura de DMUS_KERNEL_EVENT al siguiente destino. El controlador de minipuerto usa este método para descartar las estructuras de eventos usadas para que el asignador pueda reciclarlas.
Syntax
Sintaxis
NTSTATUS PutMessage(
PDMUS_KERNEL_EVENT pDMKEvt
);
Parámetros
pDMKEvt
Puntero a la estructura DMUS_KERNEL_EVENT que se pasa a su destino.
Valor devuelto
Este método devuelve NTSTATUS que contiene STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.
Comentarios
Durante la representación, el controlador de miniporta llama al método PutMessage para descartar las estructuras usadas DMUS_KERNEL_EVENT. El método enruta las estructuras descartadas al asignador para su reutilización. El controlador de minipuerto llama a este método una vez que ha extraído los datos MIDI de las estructuras para su representación.
Durante la captura MIDI, este método se usa para empaquetar y pasar mensajes MIDI al receptor de captura del controlador de puerto DMus, como se muestra en la figura en Transporte MIDI. Estos mensajes pueden ser eventos MIDI únicos, múltiples o fragmentados y se empaquetan en estructuras de DMUS_KERNEL_EVENT (recuperadas por las llamadas IAllocatorMXF::GetMessage).
El asignador siempre es el último destino de cualquier cadena, por lo que cada estructura de DMUS_KERNEL_EVENT se reciclará finalmente. Si no se ha llamado a IMXF::ConnectOutput, PutMessage pasará de forma predeterminada la estructura al asignador. Para obtener más información, vea Asignador.
Requisitos
Requisito | Valor |
---|---|
Header | dmusicks.h |
IRQL | DISPATCH_LEVEL |