estrutura SERCX2_CONFIG (sercx.h)

Artigo
08/07/2023

A estrutura SERCX2_CONFIG contém informações de configuração para a versão 2 da extensão da estrutura serial (SerCx2).

Sintaxe

typedef struct _SERCX2_CONFIG {
  ULONG                                            Size;
  PFN_SERCX2_FILEOPEN                              EvtSerCx2FileOpen;
  PFN_SERCX2_FILECLOSE                             EvtSerCx2FileClose;
  PFN_SERCX2_SET_WAIT_MASK                         EvtSerCx2SetWaitMask;
  PFN_SERCX2_PURGE_FIFOS                           EvtSerCx2PurgeFifos;
  PFN_SERCX2_CONTROL                               EvtSerCx2Control;
  PFN_SERCX2_APPLY_CONFIG                          EvtSerCx2ApplyConfig;
  PFN_SERCX2_SELECT_NEXT_RECEIVE_TRANSACTION_TYPE  EvtSerCx2SelectNextReceiveTransactionType;
  PFN_SERCX2_SELECT_NEXT_TRANSMIT_TRANSACTION_TYPE EvtSerCx2SelectNextTransmitTransactionType;
  PWDF_OBJECT_ATTRIBUTES                           RequestAttributes;
} SERCX2_CONFIG, *PSERCX2_CONFIG;

Membros

Size

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

EvtSerCx2FileOpen

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2FileOpen implementada pelo driver. Esse membro é opcional e pode ser definido como NULL para indicar que o driver não implementa a função. No entanto, um driver que implementa essa função também deve implementar uma função EvtSerCx2FileClose .

EvtSerCx2FileClose

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2FileClose implementada pelo driver. Esse membro é opcional e pode ser definido como NULL para indicar que o driver não implementa a função.

EvtSerCx2SetWaitMask

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2SetWaitmask implementada pelo driver. Esse membro deve apontar para uma função válida.

EvtSerCx2PurgeFifos

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2PurgeFifos implementada pelo driver. Esse membro deve apontar para uma função válida.

EvtSerCx2Control

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2Control implementada pelo driver. Esse membro deve apontar para uma função válida.

EvtSerCx2ApplyConfig

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2ApplyConfig implementada pelo driver. Esse membro deve apontar para uma função válida.

EvtSerCx2SelectNextReceiveTransactionType

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2SelectNextReceiveTransactionType implementada pelo driver. Esse membro é opcional e pode ser definido como NULL para indicar que o driver não implementa a função.

EvtSerCx2SelectNextTransmitTransactionType

Um ponteiro para a função de retorno de chamada de evento EvtSerCx2SelectNextTransmitTransactionType implementada pelo driver. Esse membro é opcional e pode ser definido como NULL para indicar que o driver não implementa a função.

RequestAttributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que descreve os atributos a serem atribuídos aos objetos de solicitação de estrutura que o SerCx2 passa para o driver do controlador serial. Antes de chamar o método SerCx2InitializeDevice , o chamador deve chamar a função WDF_OBJECT_ATTRIBUTES_INIT para inicializar a estrutura. Esse membro é opcional e pode ser especificado como WDF_NO_OBJECT_ATTRIBUTES se o driver do controlador serial não precisar atribuir atributos ao objeto . Para obter mais informações, consulte Comentários.

Comentários

O método SerCx2InitializeDevice aceita um ponteiro para uma estrutura SERCX2_CONFIG como um parâmetro de entrada. Antes de chamar SerCx2InitializeDevice, chame a função SERCX2_CONFIG_INIT para inicializar essa estrutura.

Se o membro RequestAttributes apontar para uma estrutura WDF_OBJECT_ATTRIBUTES , o chamador não deverá substituir os valores que a função de inicialização WDF_OBJECT_ATTRIBUTES_INIT grava nos membros ParentObject, ExecutionLevel e SynchronizationScope dessa estrutura.

Um driver pode precisar armazenar informações em áreas de contexto nos objetos de solicitação de estrutura que o driver recebe. Normalmente, o driver chama o método WdfDeviceInitSetRequestAttributes para especificar os atributos necessários para objetos de solicitação. Esses atributos incluem o nome e o tamanho da área de contexto em cada objeto de solicitação. Além disso, na implementação atual do SerCx2, um driver de controlador serial que requer um contexto de solicitação deve especificar esses mesmos atributos no membro RequestAttributes da estrutura SERCX2_CONFIG que o driver passa para SerCx2InitializeDevice. Ou seja, o driver deve especificar os mesmos atributos de solicitação duas vezes— na chamada SerCx2InitializeDevice e na chamada WdfDeviceInitSetRequestAttributes . Para obter mais informações, consulte Transações de Custom-Receive SerCx2 e Transações de Custom-Transmit SerCx2.

Um driver que nunca precisa de um contexto de solicitação não precisa chamar WdfDeviceInitSetRequestAttributes e pode definir o membro RequestAttributes da estrutura SERCX2_CONFIG como WDF_NO_OBJECT_ATTRIBUTES.