структура 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 вызывается из основного цикла функции передачи и получения DPC в драйвере последовательного контроллера. Эта функция вызывает SerCxGetActivity, обрабатывает полную операцию передачи или получения, а затем вызывает SerCxGetActivity, чтобы определить, требуется ли операция другого типа. Если доступно больше работы, функция DPC может выполнить эту работу перед возвратом.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 8. |
| заголовка | sercx.h |