Método IAllocatorMXF::GetMessage (dmusicks.h)
El GetMessage método actúa como punto de recuperación para cualquier componente del modo kernel de DirectMusic que utiliza el asignador del controlador de puerto para reutilizar DMUS_KERNEL_EVENT estructuras.
Sintaxis
NTSTATUS GetMessage(
[out] PDMUS_KERNEL_EVENT *ppDMKEvt
);
Parámetros
[out] ppDMKEvt
Puntero de salida para el evento MIDI. Este parámetro apunta a una variable de puntero asignada por el autor de la llamada en la que el método escribe un puntero a la estructura de eventos que se recupera del asignador. La propia estructura está vacía (cero por el asignador).
Valor devuelto
GetMessage devuelve S_OK si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.
Comentarios
El controlador miniport usa el GetMessage método para recuperar estructuras de eventos para la representación y captura MIDI. Este método recupera DMUS_KERNEL_EVENT estructuras del mismo grupo en el que IMXF::P utMessage los coloca cuando los descarta al asignador.
En el caso de una secuencia de captura MIDI, el controlador de puerto recupera los eventos de captura del controlador de miniporte cuando lo solicite el DPC de servicio habitual.
Para obtener más información sobre el asignador, vea Asignador.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | dmusicks.h (incluye Dmusicks.h) |
| IRQL | <=DISPATCH_LEVEL |