Функция SerCx2PioTransmitPurgeFifoComplete (sercx.h)
Метод SerCx2PioTransmitPurgeFifoComplete уведомляет версию 2 расширения последовательной платформы (SerCx2), что драйвер последовательного контроллера завершил очистку данных от передачи FIFO в оборудовании последовательного контроллера.
Синтаксис
void SerCx2PioTransmitPurgeFifoComplete(
[in] SERCX2PIOTRANSMIT PioTransmit,
[in] ULONG BytesPurged
);
Параметры
[in] PioTransmit
Дескриптор SERCX2PIOTRANSMIT объекту PIO-передачи. Драйвер последовательного контроллера, ранее называемый методом SerCx2PioTransmitCreate для создания этого объекта.
[in] BytesPurged
Количество байтов неотступных данных, которые драйвер последовательного контроллера очищал от передачи FIFO.
Возвращаемое значение
Никакой
Замечания
SerCx2 вызывает функцию обратного вызова события EvtSerCx2PioTransmitPurgeFifo, если она реализована, чтобы завершить текущую транзакцию передачи piO-передачи. SerCx2 ранее инициировал эту транзакцию в ответ на запрос записи (IRP_MJ_WRITE) от клиента. Например, SerCx2 может вызвать эту функцию, если клиент отменяет ожидающий запрос на запись или время ожидания записи. Дополнительные сведения см. в обработке запросов на чтение и записьSerCx2.
В ответ на вызов функции EvtSerCx2PioTransmitPurgeFifo драйвер сначала удаляет все данные, остающиеся в передаче FIFO; затем драйвер должен вызвать SerCx2PioTransmitPurgeFifoComplete, чтобы уведомить SerCx2. SerCx2 ожидает это уведомление и не завершает запрос на запись, пока не будет уведомлен.
Драйвер последовательного контроллера должен вызывать SerCx2PioTransmitPurgeFifoComplet e только в ответ на вызов функции EvtSerCx2PioTransmitPurgeFifo.
SerCx2 использует значение параметра BytesPurged, чтобы определить, сколько байтов успешно передано до очистки FIFO передачи. SerCx2 требует, чтобы эти сведения завершали запрос на запись, который истекает, или запрос на запись, отмененный после передачи одного или нескольких байтов.
Дополнительные сведения см. в разделе SerCx2 PIO-Transmit Транзакций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8.1. |
| целевая платформа | Всеобщий |
| заголовка | sercx.h |
| IRQL | <= DISPATCH_LEVEL |