Функция SerCx2PioReceiveReady (sercx.h)
Метод SerCx2PioReceiveReady уведомляет версию 2 расширения последовательной платформы (SerCx2), что данные доступны для чтения из получения FIFO в последовательном контроллере.
Синтаксис
void SerCx2PioReceiveReady(
[in] SERCX2PIORECEIVE PioReceive
);
Параметры
[in] PioReceive
Дескриптор SERCX2PIORECEIVE объекту piO-receive. Драйвер последовательного контроллера ранее вызывал метод SerCx2PioReceiveCreate для создания этого объекта.
Возвращаемое значение
Никакой
Замечания
Чтобы инициировать транзакцию получения PIO, SerCx2 вызывает функцию обратного вызова событий EvtSerCx2PioReceiveReadBuffer функцию обратного вызова событий и предоставляет буфер чтения, в который необходимо передать данные из получения FIFO в последовательном контроллере. Если возвращаемое значение из этой функции указывает, что буфер чтения был заполнен только частично, прежде чем получение FIFO стал пустым, SerCx2 вызывает EvtSerCx2PioReceiveEnableReadyNotification подпрограмму обратного вызова событий, чтобы включить готовое уведомление, когда доступны дополнительные данные для чтения.
Если готовое уведомление включено, и для чтения доступны дополнительные данные, драйвер последовательного контроллера должен вызвать SerCx2PioReceiveReady, чтобы уведомить SerCx2. В ответ на это уведомление SerCx2 снова вызывает функцию EvtSerCx2PioReceiveReadBuffer для передачи дополнительных данных из получения FIFO в буфер чтения.
Драйвер последовательного контроллера должен вызывать SerCx2PioReceiveReady только в ответ на вызов функции EvtSerCx2PioReceiveEnableReadyNotification.
Кроме того, SerCx2 использует эти готовые уведомления для обнаружения времени ожидания интервала во время обработки запроса на чтение. Дополнительные сведения о времени ожидания интервала см. в SERIAL_TIMEOUTS. Дополнительные сведения о готовых уведомлениях см. в SerCx2 PIO-Receive транзакций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8.1. |
| целевая платформа | Всеобщий |
| заголовка | sercx.h |
| IRQL | <= DISPATCH_LEVEL |