Função SerCx2CustomTransmitTransactionCreate (sercx.h)
O método SerCx2CustomTransmitTransactionCreate cria um objeto custom-transmit-transaction, que a versão 2 da extensão da estrutura serial (SerCx2) usa para executar transações de transmissão personalizada.
Sintaxe
NTSTATUS SerCx2CustomTransmitTransactionCreate(
[in] SERCX2CUSTOMTRANSMIT CustomTransmit,
[in] PSERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG CustomTransmitTransactionConfig,
[in] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] SERCX2CUSTOMTRANSMITTRANSACTION *CustomTransmitTransaction
);
Parâmetros
[in] CustomTransmit
Um identificador SERCX2CUSTOMTRANSMIT para um objeto de transmissão personalizada. O driver do controlador serial anteriormente chamou o método SerCx2CustomTransmitCreate para criar esse objeto.
[in] CustomTransmitTransactionConfig
Um ponteiro para uma estrutura SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG . Antes de chamar esse método, o chamador deve chamar a função SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG_INIT para inicializar a estrutura. Essa estrutura contém ponteiros para um conjunto de rotinas de retorno de chamada de evento implementadas pelo driver do controlador serial. O SerCx2 chama essas funções para fazer uma transação de E/S que usa o mecanismo de transferência de dados personalizado para gravar dados no controlador serial a serem transmitidos.
[in] Attributes
Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que descreve os atributos a serem atribuídos ao novo objeto custom-transmit-transaction. Antes de chamar esse método, o chamador deve chamar a função WDF_OBJECT_ATTRIBUTES_INIT para inicializar a estrutura. Esse parâmetro é 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.
[out] CustomTransmitTransaction
Um ponteiro para um local no qual esse método grava um identificador de SERCX2CUSTOMTRANSMITTRANSACTION no objeto custom-transmit-transaction recém-criado. O SerCx2 e o driver do controlador serial usam esse identificador em chamadas subsequentes para se referir a esse objeto.
Retornar valor
Esse método retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os possíveis valores retornados por erro incluem os seguintes códigos de status.
Código de retorno | Descrição |
---|---|
|
Um objeto custom-transmit-transaction já existe de uma chamada SerCx2CustomTransmitTransactionCreate anterior. |
|
O valor CustomTransmitTransactionConfig->Size não é igual a sizeof(SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG). |
|
Um valor de parâmetro não é válido. O chamador deve fornecer um ponteiro de função EvtSerCx2CustomTransmitTransactionStart válido. |
|
Recursos insuficientes estão disponíveis para criar o objeto custom-transmit-transaction. |
Comentários
O driver do controlador serial pode chamar esse método para criar um objeto custom-transmit-transaction. O SerCx2 usa esse objeto para gerenciar transações de transmissão personalizada, que são transações de E/S que usam um mecanismo de transferência de dados personalizado para gravar dados no controlador serial a ser transmitido.
Como opção, um driver de controlador serial pode usar o parâmetro Attributes para criar um contexto para o objeto de transmissão personalizada e fornecer ponteiros para as funções EvtCleanupCallback e EvtDestroyCallback que são chamadas para preparar o objeto para exclusão. Para obter mais informações, consulte WDF_OBJECT_ATTRIBUTES.
Se o parâmetro Attributes 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.
Se a combinação especificada de funções de retorno de chamada implementadas não for válida, SerCx2CustomTransmitTransactionCreate falhará e retornará STATUS_INVALID_PARAMETER.
Para obter mais informações sobre como criar objetos custom-transmit-transaction, consulte SERCX2CUSTOMTRANSMITTRANSACTION. Para obter mais informações sobre transações de transmissão personalizada, consulte Transações de Custom-Transmit SerCx2.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows 8.1. |
Plataforma de Destino | Universal |
Cabeçalho | sercx.h |
IRQL | PASSIVE_LEVEL |
Confira também
EvtSerCx2CustomTransmitTransactionStart
SERCX2CUSTOMTRANSMITTRANSACTION
SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de