Compartilhar via

Manipuladores de Objeto SerCx2

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 interface DDI (interface do driver de dispositivo) SerCx2 utiliza esses tipos de identificadores para se referir a objetos que possuem características e capacidades específicas do SerCx2.

Além disso, o SerCx2 DDI usa dois dos tipos de identificador de objeto genérico, 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 da Estrutura.

Este tópico descreve os seguintes identificadores de objeto:

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 do framework 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 de 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 aos 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 a duração de vida do objeto de estrutura que representa o dispositivo 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 opção, criar um objeto de recebimento personalizado, mas não pode criar mais do que 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 Manipulador de Objeto SERCX2PIORECEIVE.

Para obter mais informações sobre objetos de recepção de sistema-DMA, consulte SERCX2SYSTEMDMARECEIVE Identificador de Objeto.

identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION

Um identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION é uma referência não transparente a um objeto de transação de recebimento personalizado na versão 2 da extensão do framework 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 subsequentes de recebimento personalizado.

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

Depois que SerCx2CustomReceiveTransactionCreate cria o objeto custom-receive-transaction, esse objeto existe para 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 opção, criar um objeto de transação de recepção personalizada, 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 SERCX2PIORECEIVE Manipulador de Objeto. Para obter mais informações sobre objetos de recebimento personalizado, consulte Manipulador de Objeto SERCX2CUSTOMRECEIVE.

Apesar dos tempos de vida semelhantes dos objetos custom-receive e custom-receive-transaction, eles são definidos como tipos de objeto separados (e não combinados em um único 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 referir-se ao objeto em chamadas subsequentes aos métodos SerCx2 e às funções de retorno de chamada de eventos.

Depois que SerCx2CustomTransmitCreate cria o objeto de transmissão personalizada, esse objeto existe durante o tempo de vida útil do objeto de dispositivo do framework 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 opção, criar um objeto de transmissão personalizada, mas não pode criar mais do que um desses objetos.

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

  • O driver criou anteriormente um objeto de transmissão de PIO.
  • O driver não criou um objeto system-DMA-transmit.

Para obter mais informações sobre objetos de transmissão de PIO, consulte Manipulador de Objeto SERCX2PIOTRANSMIT. Para obter mais informações sobre objetos de transmissão de DMA do sistema, consulte SERCX2SYSTEMDMATRANSMIT Identificador de Objeto.

identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION

Um identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION é uma referência opaca a um objeto de transação de transmissão customizada na versão 2 da extensão do framework 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 transações de Custom-Transmit SerCx2.

Depois que SerCx2CustomTransmitTransactionCreate cria o objeto custom-transmit-transaction, esse objeto existe durante a vida útil do objeto de dispositivo da estrutura de trabalho 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 opção, criar um objeto de transmissão personalizada, mas não pode criar mais do que um desses objetos. O driver pode criar esse objeto somente nas seguintes condições:

  • O driver criou anteriormente um objeto de transmissão de PIO.
  • O driver não criou um objeto system-DMA-transmit.

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

Apesar dos tempos de vida semelhantes dos objetos de transmissão sob medida e das transações de transmissão sob medida, eles são estabelecidos 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 de recebimento de PIO na versão 2 da extensão do framework serial (SerCx2).

O método SerCx2PioReceiveCreate cria um objeto de recebimento de PIO. O SerCx2 usa objeto para gerenciar transações de E/S (PIO) programadas que leem dados do controlador serial. Esse objeto é opaco para drivers de controlador serial. fornece, como um parâmetro de saída, um handle SERCX2PIORECEIVE para o objeto de recepção de PIO 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 transações de PIO-Receive SerCx2. Depois que SerCx2PioReceiveCreate cria o objeto PIO-receive, esse objeto existe pelo ciclo de vida do objeto de dispositivo do framework que representa o 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 de recebimento de PIO 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 de recebimento de DMA do sistema, consulte SERCX2SYSTEMDMARECEIVE Identificador de Objeto. Para obter mais informações sobre objetos de recebimento personalizado, consulte SERCX2CUSTOMRECEIVE Identificador de Objeto.

identificador de objeto SERCX2PIOTRANSMIT

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

O método SerCx2PioTransmitCreate cria um objeto de transmissão PIO. O SerCx2 usa esse objeto para gerenciar transações de E/S que usam PIO (E/S programado) 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 de transmissão PIO 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 de transmissão de PIO, esse objeto existe durante a vida útil do objeto de dispositivo do framework que representa o dispositivo do controlador serial. O objeto de transmissão de PIO é 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 PIO 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 SERCX2SYSTEMDMATRANSMIT Identificador de Objeto. Para obter mais informações sobre objetos de transmissão personalizada, consulte SERCX2CUSTOMTRANSMIT Identificador de Objeto.

identificador de objeto SERCX2SYSTEMDMARECEIVE

Um identificador de objeto SERCX2SYSTEMDMARECEIVE é uma referência opaca a um objeto de recebimento por DMA do sistema na versão 2 da extensão da 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 de TransaçõesDMA-Receive do Sistema SerCx2.

Depois que SerCx2SystemDmaReceiveCreate cria o objeto system-DMA-receive, esse objeto existe durante toda a vida útil do objeto da estrutura que representa o dispositivo controlador serial. O objeto system-DMA-receive é excluído automaticamente quando o objeto do dispositivo é excluído. Um driver de controlador serial pode, como opção, criar um objeto de recebimento de DMA do sistema, mas não pode criar mais do que 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 de recebimento personalizado.

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

identificador de objeto SERCX2SYSTEMDMATRANSMIT

Um identificador de objeto SERCX2SYSTEMDMATRANSMIT é uma referência opaca a um objeto transmissor de DMA do sistema na versão 2 da extensão da 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 parâmetro de saída, um identificador SERCX2SYSTEMDMATRANSMIT para o objeto de transmissão de sistema-DMA 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 do sistema DMA subsequentes. Para obter mais informações, consulte de TransaçõesDMA-Transmit do Sistema SerCx2.

Depois que SerCx2SystemDmaTransmitCreate cria o objeto system-DMA-transmit, esse objeto existe para o tempo de vida do objeto de dispositivo da 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 de transmissão de DMA do sistema chamando um método como WdfObjectDelete.

Um driver de controlador serial pode, como opção, criar um objeto de transmissão do sistema DMA, 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 de transmissão de PIO.
  • O driver não criou um objeto de transmissão customizado.

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

Transações de Custom-Receive SerCx2

Transações de Custom-Transmit SerCx2

Transações de PIO-Receive SerCx2

Transações PIO-Transmit de SerCx2

Sistema SerCx2 - TransaçõesDMA-Receive

SerCx2 System-DMA-Transmit Transactions

SerCx2CustomReceiveTransactionCreate

SerCx2CustomTransmitCreate

SerCx2CustomTransmitTransactionCreate

SerCx2PioReceiveCreate

SerCx2PioReceiveCreate

SerCx2PioTransmitCreate

SerCx2SystemDmaReceiveCreate

SerCx2SystemDmaTransmitCreate

resumo de objetos da estrutura

WdfObjectDelete

  • Last updated on