структура SERCX_ACTIVITY (sercx.h)
Структура SERCX_ACTIVITY содержит сводку рабочих элементов, готовых для обработки драйвера последовательного контроллера.
Синтаксис
typedef struct _SERCX_ACTIVITY {
ULONG Size;
BOOLEAN Transmitting;
BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;
Члены
Size
Размер данной структуры (в байтах). Метод SerCxGetActivity использует этот элемент, чтобы определить, какую версию структуры использует вызывающий объект. Размер этой структуры может измениться в будущих версиях файла заголовка Sercx.h.
Transmitting
Выполняется ли операция передачи (записи). Этот элемент имеет значение TRUE, если выполняется операция передачи. В противном случае — FALSE.
Receiving
Выполняется ли операция получения (чтения). Этот элемент имеет значение TRUE, если выполняется операция получения. В противном случае — FALSE.
Комментарии
Эта структура должна быть инициализирована функцией SERCX_ACTIVITY_INIT перед ее первоначальным использованием. После этого вызовы метода SerCxGetActivity обновляют содержимое этой структуры, чтобы указать работу, которая в настоящее время находится в состоянии ожидания.
Структура SERCX_ACTIVITY суммирует ожидающие работы, которые расширение последовательной платформы (SerCx) назначает драйверу последовательного контроллера. Эта работа определяется запросами ввода-вывода от клиентов, но запрос ввода-вывода не обязательно порождает рабочий элемент. Например, если в буфере памяти SerCx имеется достаточное количество полученных данных для выполнения ожидающего запроса на чтение, этот запрос не приводит к тому, что получающий элемент структуры SERCX_ACTIVITY будет иметь значение TRUE.
Как правило, SerCxGetActivity вызывается из цикла main функции DPC передачи и получения в драйвере последовательного контроллера. Эта функция вызывает SerCxGetActivity, обрабатывает полную операцию передачи или получения, а затем снова вызывает SerCxGetActivity , чтобы определить, требуется ли работа для операции другого типа. Если доступно больше работы, функция DPC может выполнить эту работу, прежде чем она будет возвращена.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается начиная с Windows 8. |
| Верхняя часть | sercx.h |