Метод IMXF::P utMessage (dmusicks.h)
Метод PutMessage передает структуру DMUS_KERNEL_EVENT в следующее место назначения. Драйвер минипорта использует этот метод для отмены используемых структур событий, чтобы они могли быть переработаны распределителем.
Синтаксис
Синтаксис
NTSTATUS PutMessage(
PDMUS_KERNEL_EVENT pDMKEvt
);
Параметры
pDMKEvt
Указатель на структуру DMUS_KERNEL_EVENT, передаваемую в место назначения.
Возвращаемое значение
Этот метод возвращает NTSTATUS, содержащий STATUS_SUCCESS, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код ошибки.
Замечания
Во время отрисовки минипорт-драйвер вызывает метод PutMessage для отмены используемых DMUS_KERNEL_EVENT структур. Метод направляет удаленные структуры в распределитель для повторного использования. Драйвер минипорта вызывает этот метод после извлечения данных MIDI из структур для отрисовки.
Во время записи MIDI этот метод используется для упаковки и передачи сообщений MIDI в приемник захвата драйвера порта DMus, как показано на рисунке в MIDI Transport. Эти сообщения могут быть одними, несколькими или фрагментарными событиями MIDI и упаковываются в структуры DMUS_KERNEL_EVENT (которые извлекаются вызовами IAllocatorMXF::GetMessage).
Распределитель всегда является последним назначением в любой цепочке, поэтому каждая DMUS_KERNEL_EVENT структура в конечном итоге будет переработана. Если не был вызван IMXF::ConnectOutput, PutMessage по умолчанию передает структуру в распределитель. Дополнительные сведения см. в разделе Allocator.
Требования
| Требование | Ценность |
|---|---|
| заголовка | dmusicks.h |
| IRQL | DISPATCH_LEVEL |