estrutura SERCX_ACTIVITY (sercx.h)

Artigo
02/29/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.

Comentários

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 de estrutura serial (SerCx) atribui ao driver do controlador serial. Esse trabalho é controlado por solicitações de E/S de clientes, mas uma solicitação de E/S não gera necessariamente 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 main da função DPC de transmissão/recebimento no driver do controlador serial. Essa função chama SerCxGetActivity, processa uma operação completa de transmissão ou recebimento 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.