estrutura SERCX2_CONFIG (sercx.h)
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
Um ponteiro para o EvtSerCx2FileClose implementado pelo driver função de retorno de chamada de evento. Esse membro é opcional e pode ser definido como NULL para indicar que o driver não implementa a função.
EvtSerCx2SetWaitMask
Um ponteiro para o EvtSerCx2SetWaitmask implementado pelo driver função de retorno de chamada de evento. Esse membro deve apontar para uma função válida.
EvtSerCx2PurgeFifos
Um ponteiro para o EvtSerCx2PurgeFifos implementado pelo driver função de retorno de chamada de evento. Esse membro deve apontar para uma função válida.
EvtSerCx2Control
Um ponteiro para a função de retorno de chamada de evento EvtSerCx2Control
EvtSerCx2ApplyConfig
Um ponteiro para o EvtSerCx2ApplyConfig implementado pelo driver função de retorno de chamada de evento. Esse membro deve apontar para uma função válida.
EvtSerCx2SelectNextReceiveTransactionType
Um ponteiro para o EvtSerCx2SelectNextReceiveTransactionType implementado pelo driver função de retorno de chamada de evento. Esse membro é opcional e pode ser definido como NULL para indicar que o driver não implementa a função.
EvtSerCx2SelectNextTransmitTransactionType
Um ponteiro para o EvtSerCx2SelectNextTransmitTransactionType implementado pelo driver função de retorno de chamada de evento. 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.
Observações
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 no ParentObject, ExecutionLevele SynchronizationScope membros dessa estrutura.
Um driver pode precisar armazenar informações em áreas de contexto nos objetos de solicitação da 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 RequestAttributes membro 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
Um driver que nunca precisa de um contexto de solicitação não precisa chamar WdfDeviceInitSetRequestAttributes e pode definir o RequestAttributes membro da estrutura SERCX2_CONFIG para WDF_NO_OBJECT_ATTRIBUTES.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Suporte para começar com Windows 8.1. |
| cabeçalho | sercx.h |
Consulte também
EvtSerCx2Control
EvtSerCx2SelectNextReceiveTransactionType