Функция SerCx2SystemDmaReceiveNewDataNotification (sercx.h)
Метод SerCx2SystemDmaReceiveNewDataNotification уведомляет версию 2 расширения последовательной платформы (SerCx2), что данные доступны для чтения из получения FIFO на оборудовании последовательного контроллера.
Синтаксис
void SerCx2SystemDmaReceiveNewDataNotification(
[in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);
Параметры
[in] SystemDmaReceive
Дескриптор SERCX2SYSTEMDMARECEIVE объекту system-DMA-receive. Драйвер последовательного контроллера ранее вызвал метод SerCx2SystemDmaReceiveCreate для создания этого объекта.
Возвращаемое значение
Никакой
Замечания
Если получение FIFO в последовательном контроллере становится пустым перед завершением транзакции приема системы DMA, SerCx2 вызывает EvtSerCx2SystemDmaReceiveEnableNewDataNotification функцию обратного вызова событий, чтобы разрешить SerCx2 получать уведомление о новых данных, когда данные снова доступны для чтения из получения FIFO.
Если включено уведомление о новых данных, драйвер последовательного контроллера должен вызвать SerCx2SystemDmaReceiveNewDataNotification, чтобы уведомить SerCx2 после получения новых данных. Уведомление возникает, когда драйвер обнаруживает, что один или несколько новых байтов полученных данных готовы к передаче или уже переданы системным контроллером DMA.
Последовательный контроллер должен вызывать SerCx2SystemDmaReceiveNewDataNotification только в ответ на вызов функции EvtSerCx2SystemDmaReceiveEnableNewDataNotification.
Если драйвер последовательного контроллера поддерживает уведомления о новых данных для транзакций приема системных данных, SerCx использует эти уведомления для обнаружения интервалов времени ожидания во время обработки запросов чтения (IRP_MJ_READ) . Дополнительные сведения о времени ожидания интервала см. в SERIAL_TIMEOUTS. Дополнительные сведения о новых уведомлениях о данных см. в System-DMA-Receiveтранзакций SerCx2.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8.1. |
| целевая платформа | Всеобщий |
| заголовка | sercx.h |
| IRQL | <= DISPATCH_LEVEL |