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

Consulte también

DMUS_KERNEL_EVENT

IAllocatorMXF

IMXF::P utMessage