estrutura SERCX_CONFIG (sercx.h)

Artigo
08/07/2023

A estrutura SERCX_CONFIG contém informações de configuração para a extensão de estrutura serial (SerCx).

Sintaxe

typedef struct _SERCX_CONFIG {
  ULONG                     Size;
  WDF_TRI_STATE             PowerManaged;
  PFN_SERCX_FILEOPEN        EvtSerCxFileOpen;
  PFN_SERCX_FILECLOSE       EvtSerCxFileClose;
  PFN_SERCX_FILECLEANUP     EvtSerCxFileCleanup;
  PFN_SERCX_TRANSMIT        EvtSerCxTransmit;
  PFN_SERCX_RECEIVE         EvtSerCxReceive;
  PFN_SERCX_WAITMASK        EvtSerCxWaitmask;
  PFN_SERCX_PURGE           EvtSerCxPurge;
  PFN_SERCX_CONTROL         EvtSerCxControl;
  PFN_SERCX_APPLY_CONFIG    EvtSerCxApplyConfig;
  PFN_SERCX_TRANSMIT_CANCEL EvtSerCxTransmitCancel;
  PFN_SERCX_RECEIVE_CANCEL  EvtSerCxReceiveCancel;
} SERCX_CONFIG, *PSERCX_CONFIG;

Membros

Size

O tamanho, em bytes, dessa estrutura. O método SerCxInitialize 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.

PowerManaged

Se a fila do controlador deve ser gerenciada por energia. Se definido como WdfTrue, a fila do controlador deverá ser gerenciada por energia. Se definido como WdfFalse, a fila do controlador não será gerenciada por energia. Se definido como WdfDefault, a fila do controlador deverá ser gerenciada por energia, a menos que o driver chame o método WdfFdoInitSetFilter . Para obter mais informações, consulte a descrição do membro PowerManaged no WDF_IO_QUEUE_CONFIG.

EvtSerCxFileOpen

Um ponteiro para a função de retorno de chamada EvtSerCxFileOpen do driver do controlador. Esse membro é opcional e pode ser definido como NULL.

EvtSerCxFileClose

Um ponteiro para a função de retorno de chamada EvtSerCxFileClose do driver do controlador. Esse membro é opcional e pode ser definido como NULL.

EvtSerCxFileCleanup

Um ponteiro para a função de retorno de chamada EvtSerCxFileCleanup do driver do controlador. Esse membro é opcional e pode ser definido como NULL.

EvtSerCxTransmit

Um ponteiro para a função de retorno de chamada EvtSerCxTransmit do driver do controlador. Esse membro é necessário para apontar para uma função de retorno de chamada válida.

EvtSerCxReceive

Um ponteiro para a função de retorno de chamada EvtSerCxReceive do driver do controlador. Esse membro é necessário para apontar para uma função de retorno de chamada válida.

EvtSerCxWaitmask

Um ponteiro para a função de retorno de chamada EvtSerCxWaitmask do driver do controlador. Esse membro é necessário para apontar para uma função de retorno de chamada válida.

EvtSerCxPurge

Um ponteiro para a função de retorno de chamada EvtSerCxPurge do driver do controlador. Esse membro é opcional e pode ser definido como NULL.

EvtSerCxControl

Um ponteiro para a função de retorno de chamada EvtSerCxControl do driver do controlador. Esse membro é necessário para apontar para uma função de retorno de chamada válida.

EvtSerCxApplyConfig

Um ponteiro para a função de retorno de chamada EvtSerCxApplyConfig do driver do controlador. Esse membro é necessário para apontar para uma função de retorno de chamada válida.

EvtSerCxTransmitCancel

Um ponteiro para a função de retorno de chamada EvtSerCxTransmitCancel do driver do controlador. Esse membro é opcional e pode ser definido como NULL.

EvtSerCxReceiveCancel

Um ponteiro para a função de retorno de chamada EvtSerCxReceiveCancel do driver do controlador. Esse membro é opcional e pode ser definido como NULL.

Comentários

Antes que essa estrutura seja passada para o método SerCxInitialize , ela deve ser inicializada pela função SERCX_CONFIG_INIT e modificada pelo driver do controlador para definir os ponteiros da função de retorno de chamada e o membro PowerManaged .