Метод IAllocatorMXF::GetMessage (dmusicks.h)

  • Статья

Метод GetMessage служит точкой извлечения для любого компонента DirectMusic в режиме ядра, который использует распределител драйвера порта для повторного использования DMUS_KERNEL_EVENT структур.

Синтаксис

NTSTATUS GetMessage(
  [out] PDMUS_KERNEL_EVENT *ppDMKEvt
);

Параметры

[out] ppDMKEvt

Выходной указатель для события MIDI. Этот параметр указывает на переменную указателя, выделенную вызывающим объектом, в которую метод записывает указатель на структуру событий, извлекаемую из распределителя. Сама структура пуста (обнуляется распределителем).

Возвращаемое значение

GetMessage возвращает S_OK, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код ошибки.

Комментарии

Драйвер мини-порта использует метод для GetMessage получения структур событий для отрисовки и записи MIDI. Этот метод извлекает DMUS_KERNEL_EVENT структуры из того же пула, в который IMXF::P utMessage помещает их при их удалении в распределителе.

В случае потока записи MIDI драйвер порта получает события записи из драйвера мини-порта при появлении запроса обычного DPC службы.

Дополнительные сведения о распределителе см. в разделе Распределителя.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dmusicks.h (включая Dmusicks.h)
IRQL <=DISPATCH_LEVEL

См. также раздел

DMUS_KERNEL_EVENT

IAllocatorMXF

IMXF::P utMessage