Метод 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 |