estrutura SERCX_ACTIVITY (sercx.h)

Artigo
12/15/2024

A estrutura SERCX_ACTIVITY contém um resumo dos itens de trabalho que estão prontos para o driver do controlador serial processar.

Sintaxe

typedef struct _SERCX_ACTIVITY {
  ULONG   Size;
  BOOLEAN Transmitting;
  BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;

Membros

Size

O tamanho, em bytes, dessa estrutura. O método SerCxGetActivity usa esse membro para determinar qual versão da estrutura o chamador está usando. O tamanho dessa estrutura pode mudar em versões futuras do arquivo de cabeçalho Sercx.h.

Transmitting

Se uma operação de transmissão (gravação) está em andamento. Esse membro será TRUE se uma operação de transmissão estiver em andamento. Caso contrário, será FALSE.

Receiving

Se uma operação de recebimento (leitura) está em andamento. Esse membro será TRUE se uma operação de recebimento estiver em andamento. Caso contrário, será FALSE.

Observações

Essa estrutura deve ser inicializada pela função SERCX_ACTIVITY_INIT antes de seu uso inicial. Depois disso, as chamadas para o método SerCxGetActivity atualizam o conteúdo dessa estrutura para indicar o trabalho que está pendente no momento.

A estrutura SERCX_ACTIVITY resume o trabalho pendente que a extensão da estrutura serial (SerCx) atribui ao driver do controlador serial. Esse trabalho é impulsionado por solicitações de E/S de clientes, mas uma solicitação de E/S não necessariamente gera um item de trabalho. Por exemplo, se o SerCx tiver uma quantidade suficiente de dados recebidos em seu buffer de memória para concluir uma solicitação de leitura pendente, essa solicitação não fará com que o membro Receptor da estrutura SERCX_ACTIVITY seja definido como TRUE.

Normalmente, SerCxGetActivity é chamado do loop principal da função DPC de transmissão/recebimento no driver do controlador serial. Essa função chama SerCxGetActivity, processa uma operação de transmissão ou recebimento completa e, em seguida, chama SerCxGetActivity novamente para determinar se uma operação de outro tipo requer trabalho. Se houver mais trabalho disponível, a função DPC poderá executar esse trabalho antes de retornar.