Метод 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.
Дополнительные сведения об распределителе см. в allocator.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | dmusicks.h (include Dmusicks.h) |
| IRQL | <=DISPATCH_LEVEL |