Identificadores de objeto SerCx2

Artigo
03/18/2023

Este tópico descreve os tipos de identificador de objeto definidos especificamente para a versão 2 da extensão da estrutura serial (SerCx2).

A DDI (interface de driver de dispositivo) SerCx2 usa esses tipos de identificador para se referir a objetos que têm recursos e funcionalidades específicos do SerCx2.

Além disso, o SerCx2 DDI usa dois dos tipos genéricos de identificador de objeto, WDFDEVICE e WDFREQUEST, que são definidos pelo KMDF (Kernel-Mode Driver Framework).

Para obter mais informações sobre tipos de identificador de estrutura, consulte Resumo de objetos de estrutura.

Este tópico descreve os seguintes identificadores de objeto:

Identificador de objeto SERCX2CUSTOMRECEIVE
Identificador do objeto SERCX2CUSTOMRECEIVETRANSACTION
Identificador de objeto SERCX2CUSTOMTRANSMIT
Identificador do objeto SERCX2CUSTOMTRANSMITTRANSACTION
Identificador de objeto SERCX2PIORECEIVE
Identificador de objeto SERCX2PIOTRANSMIT
Identificador de objeto SERCX2SYSTEMDMARECEIVE
Identificador de objeto SERCX2SYSTEMDMATRANSMIT

Cabeçalho: 2.0\Sercx.h

Identificador de objeto SERCX2CUSTOMRECEIVE

Um identificador de objeto SERCX2CUSTOMRECEIVE é uma referência opaca a um objeto de recebimento personalizado na versão 2 da extensão da estrutura serial (SerCx2).

O método SerCx2CustomReceiveCreate cria um objeto de recebimento personalizado. O SerCx2 usa esse objeto para gerenciar transações de E/S que usam um mecanismo de transferência de dados personalizado para ler dados do controlador serial. Esse objeto é opaco para drivers de controlador serial.

SerCx2CustomReceiveCreate fornece, como um parâmetro de saída, um identificador SERCX2CUSTOMRECEIVE para o objeto de recebimento personalizado recém-criado.

O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em chamadas subsequentes para métodos SerCx2 e funções de retorno de chamada de evento.

Depois que SerCx2CustomReceiveCreate cria o objeto de recebimento personalizado, esse objeto existe durante o tempo de vida do objeto de dispositivo da estrutura que representa o dispositivo do controlador serial. O objeto de recebimento personalizado é excluído automaticamente quando o objeto do dispositivo é excluído. O driver do controlador serial não deve tentar excluir o objeto de recebimento personalizado chamando um método como WdfObjectDelete.

Um driver de controlador serial pode, como uma opção, criar um objeto de recebimento personalizado, mas não pode criar mais de um desses objetos.

O driver pode criar esse objeto somente nas seguintes condições:

O driver criou anteriormente um objeto pio-receive.
O driver não criou um objeto system-DMA-receive.

Para obter mais informações sobre objetos de recebimento de PIO, consulte Identificador de objeto SERCX2PIORECEIVE.

Para obter mais informações sobre objetos system-DMA-receive, consulte Identificador de objeto SERCX2SYSTEMDMARECEIVE.

Identificador do objeto SERCX2CUSTOMRECEIVETRANSACTION

Um identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION é uma referência opaca a um objeto custom-receive-transaction na versão 2 da extensão da estrutura serial (SerCx2).

O método SerCx2CustomReceiveTransactionCreate cria um objeto custom-receive-transaction. O SerCx2 usa esse objeto para gerenciar transações de E/S que usam um mecanismo de transferência de dados personalizado para ler dados recebidos pelo controlador serial.

Esse objeto é opaco para drivers de controlador serial.

SerCx2CustomReceiveTransactionCreate fornece, como um parâmetro de saída, um identificador SERCX2CUSTOMRECEIVETRANSACTION para o objeto custom-receive-transaction recém-criado.

O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em transações de recebimento personalizado subsequentes.

Para obter mais informações, consulte SerCx2 Custom-Receive Transactions.

Depois que SerCx2CustomReceiveTransactionCreate cria o objeto custom-receive-transaction, esse objeto existe durante o tempo de vida do objeto de dispositivo da estrutura que representa o dispositivo do controlador serial.

O objeto custom-receive-transaction é excluído automaticamente quando o objeto do dispositivo é excluído.

O driver do controlador serial não deve tentar excluir o objeto custom-receive-transaction chamando um método como WdfObjectDelete.

Um driver de controlador serial pode, como uma opção, criar um objeto custom-receive-transaction, mas não pode criar mais do que um desses objetos.

O driver pode criar esse objeto somente nas seguintes condições:</wdcml:p>

O driver criou anteriormente um objeto pio-receive.
O driver criou anteriormente um objeto de recebimento personalizado.

Para obter mais informações sobre objetos de recebimento de PIO, consulte Identificador de objeto SERCX2PIORECEIVE. Para obter mais informações sobre objetos de recebimento personalizados, consulte Identificador de objeto SERCX2CUSTOMRECEIVE.

Apesar dos tempos de vida semelhantes de objetos custom-receive e custom-receive-transaction, eles são definidos como tipos de objeto separados (e não combinados em um tipo) para dar suporte à possível expansão futura da interface do driver de dispositivo SerCx2.

Identificador de objeto SERCX2CUSTOMTRANSMIT

Um identificador de objeto SERCX2CUSTOMTRANSMIT é uma referência opaca a um objeto de transmissão personalizada na versão 2 da extensão da estrutura serial (SerCx2).

O método SerCx2CustomTransmitCreate cria um objeto de transmissão personalizada.h SerCx2 usa esse objeto para gerenciar transações de E/S que gravam dados no controlador serial. Esse objeto é opaco para drivers de controlador serial.

SerCx2CustomTransmitCreate fornece, como um parâmetro de saída, um identificador SERCX2CUSTOMTRANSMIT para o objeto de transmissão personalizada recém-criado. O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em chamadas subsequentes para métodos SerCx2 e funções de retorno de chamada de evento.

Depois que SerCx2CustomTransmitCreate cria o objeto de transmissão personalizada, esse objeto existe durante o tempo de vida do objeto de dispositivo da estrutura que representa o dispositivo do controlador serial.

O objeto de transmissão personalizada é excluído automaticamente quando o objeto do dispositivo é excluído. O driver do controlador serial não deve tentar excluir o objeto de transmissão personalizada chamando um método como WdfObjectDelete.

Um driver de controlador serial pode, como uma opção, criar um objeto de transmissão personalizada, mas não pode criar mais de um desses objetos.

O driver pode criar esse objeto somente nas seguintes condições:

O driver criou anteriormente um objeto pio-transmit.
O driver não criou um objeto system-DMA-transmit.

Para obter mais informações sobre objetos de transmissão de PIO, consulte Identificador de objeto SERCX2PIOTRANSMIT. Para obter mais informações sobre objetos system-DMA-transmit, consulte Identificador de objeto SERCX2SYSTEMDMATRANSMIT.

Identificador do objeto SERCX2CUSTOMTRANSMITTRANSACTION

Um identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION é uma referência opaca a um objeto custom-transmit-transaction na versão 2 da extensão da estrutura serial (SerCx2).

O método SerCx2CustomTransmitTransactionCreate cria um objeto custom-transmit-transaction. O SerCx2 usa esse objeto para gerenciar transações de E/S que usam um mecanismo de transferência de dados personalizado para gravar dados no controlador serial. Esse objeto é opaco para drivers de controlador serial.

SerCx2CustomTransmitTransactionCreate fornece, como um parâmetro de saída, um identificador SERCX2CUSTOMTRANSMITTRANSACTION para o objeto custom-transmit-transaction recém-criado. O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em transações de transmissão personalizada subsequentes.

Para obter mais informações, consulte SerCx2 Custom-Transmit Transactions.

Depois que SerCx2CustomTransmitTransactionCreate cria o objeto custom-transmit-transaction, esse objeto existe durante o tempo de vida do objeto de dispositivo da estrutura que representa o dispositivo do controlador serial. O objeto custom-transmit-transaction é excluído automaticamente quando o objeto do dispositivo é excluído. O driver do controlador serial não deve tentar excluir o objeto custom-transmit-transaction chamando um método como WdfObjectDelete.

Um driver de controlador serial pode, como uma opção, criar um objeto de transmissão personalizada, mas não pode criar mais de um desses objetos. O driver pode criar esse objeto somente nas seguintes condições:

O driver criou anteriormente um objeto pio-transmit.
O driver não criou um objeto system-DMA-transmit.

Para obter mais informações sobre objetos de transmissão de PIO, consulte Identificador de objeto SERCX2PIOTRANSMIT. Para obter mais informações sobre objetos de transmissão personalizada, consulte Identificador de objeto SERCX2CUSTOMTRANSMIT.

Apesar dos tempos de vida semelhantes dos objetos custom-transmit e custom-transmit-transaction, eles são definidos como tipos de objeto separados (e não combinados em um tipo) para dar suporte à possível expansão futura da interface do driver de dispositivo SerCx2.

Identificador de objeto SERCX2PIORECEIVE

Um identificador de objeto SERCX2PIORECEIVE é uma referência opaca a um objeto pio-receive na versão 2 da extensão da estrutura serial (SerCx2).

O método SerCx2PioReceiveCreate cria um objeto de recebimento de PIO. O SerCx2 usa o objeto para gerenciar transações de PIO (E/S) programadas que leem dados do controlador serial. Esse objeto é opaco para drivers de controlador serial. fornece, como um parâmetro de saída, um identificador SERCX2PIORECEIVE para o objeto pio-receive recém-criado. O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em transações subsequentes de recebimento de PIO.

Para obter mais informações, consulte SerCx2 PIO-Receive Transactions. Depois que SerCx2PioReceiveCreate cria o objeto de recebimento de PIO, esse objeto existe durante o tempo de vida do objeto de dispositivo da estrutura que representa o dispositivo do controlador serial. O objeto de recebimento de PIO é excluído automaticamente quando o objeto do dispositivo é excluído. O driver do controlador serial não deve tentar excluir o objeto pio-receive chamando um método como WdfObjectDelete.

Um driver de controlador serial deve criar um e apenas um objeto de recebimento de PIO. O driver deve criar esse objeto antes de criar um objeto system-DMA-receive ou um objeto de recebimento personalizado. Para obter mais informações sobre objetos system-DMA-receive, consulte Identificador de objeto SERCX2SYSTEMDMARECEIVE. Para obter mais informações sobre objetos de recebimento personalizados, consulte Identificador de objeto SERCX2CUSTOMRECEIVE.

Identificador de objeto SERCX2PIOTRANSMIT

Um identificador de objeto SERCX2PIOTRANSMIT é uma referência opaca a um objeto pio-transmit na versão 2 da extensão de estrutura serial (SerCx2).

O método SerCx2PioTransmitCreate cria um objeto pio-transmit. O SerCx2 usa esse objeto para gerenciar transações de E/S que usam E/S programada (PIO) para gravar dados no controlador serial. Esse objeto é opaco para drivers de controlador serial. SerCx2PioTransmitCreate fornece, como um parâmetro de saída, um identificador SERCX2PIOTRANSMIT para o objeto pio-transmit recém-criado. O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em transações de transmissão de PIO subsequentes. Para obter mais informações, consulte SerCx2 PIO-Transmit Transactions. Depois que SerCx2PioTransmitCreate cria o objeto pio-transmit, esse objeto existe para o tempo de vida do objeto de dispositivo de estrutura que representa o dispositivo do controlador serial. O objeto pio-transmit é excluído automaticamente quando o objeto do dispositivo é excluído. O driver do controlador serial não deve tentar excluir o objeto pio-transmit chamando um método como WdfObjectDelete.

Um driver de controlador serial deve criar um e apenas um objeto de transmissão PIO. O driver deve criar esse objeto antes de criar um objeto system-DMA-transmit ou um objeto de transmissão personalizada. Para obter mais informações sobre objetos de transmissão de DMA do sistema, consulte Identificador de objeto SERCX2SYSTEMDMATRANSMIT. Para obter mais informações sobre objetos de transmissão personalizada, consulte Identificador de objeto SERCX2CUSTOMTRANSMIT.

Identificador de objeto SERCX2SYSTEMDMARECEIVE

Um identificador de objeto SERCX2SYSTEMDMARECEIVE é uma referência opaca a um objeto system-DMA-receive na versão 2 da extensão de estrutura serial (SerCx2).

O método SerCx2SystemDmaReceiveCreate cria um objeto system-DMA-receive. O SerCx2 usa esse objeto para gerenciar transações de DMA do sistema que leem dados do controlador serial. Esse objeto é opaco para drivers de controlador serial. SerCx2SystemDmaReceiveCreate fornece, como um parâmetro de saída, um identificador SERCX2SYSTEMDMARECEIVE para o objeto system-DMA-receive recém-criado. O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em transações subsequentes de recebimento de DMA do sistema. Para obter mais informações, consulte SerCx2 System-DMA-Receive Transactions.

Depois que SerCx2SystemDmaReceiveCreate cria o objeto system-DMA-receive, esse objeto existe para o tempo de vida do objeto de dispositivo de estrutura que representa o dispositivo do controlador serial. O objeto system-DMA-receive é excluído automaticamente quando o objeto do dispositivo é excluído. Um driver de controlador serial pode, como uma opção, criar um objeto system-DMA-receive, mas não pode criar mais do que um desses objetos. O driver só pode criar esse objeto sob as seguintes condições:

O driver criou anteriormente um objeto pio-receive.
O driver não criou um objeto de recebimento personalizado.

Para obter mais informações sobre objetos de recebimento de PIO, consulte Identificador de objeto SERCX2PIORECEIVE. Para obter mais informações sobre objetos de recebimento personalizado, consulte Identificador de objeto SERCX2CUSTOMRECEIVE.

Identificador de objeto SERCX2SYSTEMDMATRANSMIT

Um identificador de objeto SERCX2SYSTEMDMATRANSMIT é uma referência opaca a um objeto system-DMA-transmit na versão 2 da extensão de estrutura serial (SerCx2).

O método SerCx2SystemDmaTransmitCreate cria um objeto system-DMA-transmit. O SerCx2 usa esse objeto para gerenciar transações de DMA do sistema que gravam dados no controlador serial. Esse objeto é opaco para drivers de controlador serial. SerCx2SystemDmaTransmitCreate fornece, como um parâmetro de saída, um identificador SERCX2SYSTEMDMATRANSMIT para o objeto system-DMA-transmit recém-criado. O SerCx2 e o driver do controlador serial usam esse identificador para se referir ao objeto em transações de transmissão de DMA do sistema subsequentes. Para obter mais informações, consulte SerCx2 System-DMA-Transmit Transactions.

Depois que SerCx2SystemDmaTransmitCreate cria o objeto system-DMA-transmit, esse objeto existe para o tempo de vida do objeto de dispositivo de estrutura que representa o dispositivo do controlador serial. O objeto system-DMA-transmit é excluído automaticamente quando o objeto do dispositivo é excluído. O driver do controlador serial não deve tentar excluir o objeto system-DMA-transmit chamando um método como WdfObjectDelete.

Um driver de controlador serial pode, como uma opção, criar um objeto system-DMA-transmit, mas não pode criar mais do que um desses objetos. O driver pode criar esse objeto somente nas seguintes condições:</wdcml:p>