Método IAllocatorMXF::GetMessage (dmusicks.h)
El método GetMessage sirve como punto de recuperación para cualquier componente del modo kernel de DirectMusic que utilice 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 (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.
Observaciones
El controlador miniport usa el método GetMessage para recuperar estructuras de eventos para la representación y captura MIDI. Este método recupera DMUS_KERNEL_EVENT estructuras del mismo grupo que IMXF::P utMessage los coloca en cuando los descarta en el asignador.
En el caso de una secuencia de captura MIDI, el controlador de puerto recupera los eventos de captura del controlador de miniport cuando lo solicite el DPC de servicio habitual.
Para obtener más información sobre el asignador, vea Asignador.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dmusicks.h (incluye Dmusicks.h) |
| irQL | <=DISPATCH_LEVEL |