Identificadores de objeto SerCx2
En este tema se describen los tipos de identificador de objetos que se definen específicamente para la versión 2 de la extensión del marco de trabajo serie (SerCx2).
La interfaz del controlador de dispositivo SerCx2 (DDI) usa estos tipos de identificadores para hacer referencia a objetos que tienen características y funcionalidades específicas de SerCx2.
Además, el SerCx2 DDI usa dos de los tipos de identificadores de objetos genéricos, WDFDEVICE y WDFREQUEST, definidos por el marco de controlador de Kernel-Mode (KMDF).
Para obtener más información sobre los tipos de identificadores de marco, vea Resumen de objetos de marco.
En este tema se describen los siguientes identificadores de objeto:
- Identificador de objeto SERCX2CUSTOMRECEIVE
- Identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION
- Identificador de objeto SERCX2CUSTOMTRANSMIT
- Identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION
- Identificador de objeto SERCX2PIORECEIVE
- Identificador de objeto SERCX2PIOTRANSMIT
- Identificador de objeto SERCX2SYSTEMDMARECEIVE
- Identificador de objeto SERCX2SYSTEMDMATRANSMIT
Encabezado: 2.0\Sercx.h
Identificador de objeto SERCX2CUSTOMRECEIVE
Un identificador de objeto SERCX2CUSTOMRECEIVE es una referencia opaca a un objeto de recepción personalizada en la versión 2 de la extensión del marco de trabajo serie (SerCx2).
El método SerCx2CustomReceiveCreate crea un objeto de recepción personalizado. SerCx2 usa este objeto para administrar transacciones de E/S que usan un mecanismo de transferencia de datos personalizado para leer datos del controlador serie. Este objeto es opaco para los controladores del controlador serie.
SerCx2CustomReceiveCreate proporciona, como parámetro de salida, un identificador SERCX2CUSTOMRECEIVE al objeto de recepción personalizado recién creado.
SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en llamadas posteriores a métodos SerCx2 y funciones de devolución de llamada de eventos.
Después de serCx2CustomReceiveCreate crea el objeto de recepción personalizada, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo del controlador serie. El objeto de recepción personalizada se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador del controlador serie no debe intentar eliminar el objeto de recepción personalizada llamando a un método como WdfObjectDelete.
Un controlador de controlador de serie puede, como opción, crear un objeto de recepción personalizada, pero no puede crear más de un objeto de este tipo.
El controlador solo puede crear este objeto en las condiciones siguientes:
- El controlador creó previamente un objeto PIO-receive.
- El controlador no ha creado un objeto system-DMA-receive.
Para obtener más información sobre los objetos PIO-receive, vea SERCX2PIORECEIVE Object Handle.
Para obtener más información sobre los objetos system-DMA-receive, vea SERCX2SYSTEMDMARECEIVE Object Handle.
Identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION
Un identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION es una referencia opaca a un objeto custom-receive-transaction en la versión 2 de la extensión del marco de trabajo serie (SerCx2).
El método SerCx2CustomReceiveTransactionCreate crea un objeto custom-receive-transaction. SerCx2 usa este objeto para administrar transacciones de E/S que usan un mecanismo de transferencia de datos personalizado para leer los datos recibidos por el controlador serie.
Este objeto es opaco para los controladores del controlador serie.
SerCx2CustomReceiveTransactionCreate proporciona, como parámetro de salida, un identificador SERCX2CUSTOMRECEIVETRANSACTION al objeto custom-receive-transaction recién creado.
SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en las transacciones posteriores de recepción personalizada.
Para obtener más información, consulte SerCx2 Custom-Receive Transactions.
Después de serCx2CustomReceiveTransactionCreate crea el objeto custom-receive-transaction, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo del controlador serie.
El objeto custom-receive-transaction se elimina automáticamente cuando se elimina el objeto de dispositivo.
El controlador de serie no debe intentar eliminar el objeto custom-receive-transaction llamando a un método como WdfObjectDelete.
Un controlador de controlador de serie puede, como opción, crear un objeto custom-receive-transaction, pero no puede crear más de un objeto de este tipo.
El controlador solo puede crear este objeto en las siguientes condiciones:</wdcml:p>
- El controlador creó previamente un objeto PIO-receive.
- El controlador creó previamente un objeto de recepción personalizado.
Para obtener más información sobre los objetos PIO-receive, vea SERCX2PIORECEIVE Object Handle. Para obtener más información sobre los objetos de recepción personalizada, vea SERCX2CUSTOMRECEIVE Object Handle.
A pesar de las duraciones similares de los objetos custom-receive-receive-transaction, estos se definen como tipos de objeto independientes (y no combinados en un tipo) para admitir la posible expansión futura de la interfaz del controlador de dispositivo SerCx2.
Identificador de objeto SERCX2CUSTOMTRANSMIT
Un identificador de objeto SERCX2CUSTOMTRANSMIT es una referencia opaca a un objeto de transmisión personalizada en la versión 2 de la extensión del marco de trabajo serie (SerCx2).
El método SerCx2CustomTransmitCreate crea un objeto de transmisión personalizada.h SerCx2 usa este objeto para administrar transacciones de E/S que escriben datos en el controlador serie. Este objeto es opaco para los controladores del controlador serie.
SerCx2CustomTransmitCreate proporciona, como parámetro de salida, un identificador SERCX2CUSTOMTRANSMIT al objeto de transmisión personalizada recién creado. SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en llamadas posteriores a métodos SerCx2 y funciones de devolución de llamada de eventos.
Una vez que SerCx2CustomTransmitCreate crea el objeto de transmisión personalizada, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo del controlador serie.
El objeto de transmisión personalizada se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador de controlador de serie no debe intentar eliminar el objeto de transmisión personalizada llamando a un método como WdfObjectDelete.
Un controlador de controlador de serie puede, como opción, crear un objeto de transmisión personalizada, pero no puede crear más de un objeto de este tipo.
El controlador solo puede crear este objeto en las condiciones siguientes:
- El controlador creó previamente un objeto PIO-transmit.
- El controlador no ha creado un objeto system-DMA-transmit.
Para obtener más información sobre los objetos PIO-transmit, vea SERCX2PIOTRANSMIT Object Handle. Para obtener más información sobre los objetos system-DMA-transmit, vea SERCX2SYSTEMDMATRANSMIT Object Handle.
Identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION
Un identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION es una referencia opaca a un objeto custom-transmit-transaction en la versión 2 de la extensión del marco de trabajo serie (SerCx2).
El método SerCx2CustomTransmitTransactionCreate crea un objeto custom-transmit-transaction. SerCx2 usa este objeto para administrar transacciones de E/S que usan un mecanismo de transferencia de datos personalizado para escribir datos en el controlador serie. Este objeto es opaco para los controladores del controlador serie.
SerCx2CustomTransmitTransactionCreate proporciona, como parámetro de salida, un identificador SERCX2CUSTOMTRANSMITTRANSACTION al objeto custom-transmit-transaction recién creado. SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en transacciones posteriores de transmisión personalizada.
Para obtener más información, consulte SerCx2 Custom-Transmit Transactions.
Después de serCx2CustomTransmitTransactionCreate crea el objeto custom-transmit-transaction, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo del controlador serie. El objeto custom-transmit-transaction se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador de serie no debe intentar eliminar el objeto custom-transmit-transaction llamando a un método como WdfObjectDelete.
Un controlador de controlador de serie puede, como opción, crear un objeto de transmisión personalizada, pero no puede crear más de un objeto de este tipo. El controlador solo puede crear este objeto en las condiciones siguientes:
- El controlador creó previamente un objeto PIO-transmit.
- El controlador no ha creado un objeto system-DMA-transmit.
Para obtener más información sobre los objetos PIO-transmit, vea SERCX2PIOTRANSMIT Object Handle. Para obtener más información sobre los objetos de transmisión personalizada, vea SerCX2CUSTOMTRANSMIT (Identificador de objeto).
A pesar de las duraciones similares de los objetos custom-transmit y custom-transmit-transaction, estos se definen como tipos de objeto independientes (y no combinados en un tipo) para admitir la posible expansión futura de la interfaz del controlador de dispositivo SerCx2.
Identificador de objeto SERCX2PIORECEIVE
Un identificador de objeto SERCX2PIORECEIVE es una referencia opaca a un objeto PIO-receive en la versión 2 de la extensión del marco de trabajo serie (SerCx2).
El método SerCx2PioReceiveCreate crea un objeto PIO-receive. SerCx2 utiliza el objeto para administrar transacciones de E/S programadas (PIO) que leen datos del controlador serie. Este objeto es opaco para los controladores del controlador serie. proporciona, como parámetro de salida, un identificador SERCX2PIORECEIVE al objeto pio-receive recién creado. SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en las transacciones posteriores de recepción de PIO.
Para obtener más información, consulte SerCx2 PIO-Receive Transactions. Después de SerCx2PioReceiveCreate crea el objeto PIO-receive, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo del controlador serie. El objeto PIO-receive se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador de controlador de serie no debe intentar eliminar el objeto PIO-receive llamando a un método como WdfObjectDelete.
Un controlador de controlador serie debe crear uno y solo un objeto pio-receive. El controlador debe crear este objeto antes de crear un objeto system-DMA-receive o un objeto de recepción personalizada. Para obtener más información sobre los objetos system-DMA-receive, vea SERCX2SYSTEMDMARECEIVE Object Handle. Para obtener más información sobre los objetos de recepción personalizada, vea SERCX2CUSTOMRECEIVE Object Handle.
Identificador de objeto SERCX2PIOTRANSMIT
Un identificador de objeto SERCX2PIOTRANSMIT es una referencia opaca a un objeto pio-transmit en la versión 2 de la extensión de marco de trabajo serie (SerCx2).
El método SerCx2PioTransmitCreate crea un objeto pio-transmit. SerCx2 utiliza este objeto para administrar transacciones de E/S que usan E/S programadas (PIO) para escribir datos en el controlador serie. Este objeto es opaco para los controladores de controladora serie. SerCx2PioTransmitCreate proporciona, como parámetro de salida, un identificador SERCX2PIOTRANSMIT al objeto pio-transmit recién creado. SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en transacciones posteriores de transmisión de PIO. Para obtener más información, vea SerCx2 PIO-Transmit Transactions. Después de SerCx2PioTransmitCreate crea el objeto PIO-transmit, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo de controlador serie. El objeto PIO-transmit se elimina automáticamente cuando se elimina el objeto del dispositivo. El controlador de controlador serie no debe intentar eliminar el objeto pio-transmit llamando a un método como WdfObjectDelete.
Un controlador de controlador de serie debe crear uno y solo un objeto pio-transmit. El controlador debe crear este objeto antes de crear un objeto system-DMA-transmit o un objeto de transmisión personalizada. Para obtener más información sobre los objetos system-DMA-transmit, vea SERCX2SYSTEMDMATRANSMIT Object Handle. Para obtener más información sobre los objetos de transmisión personalizada, vea SERCX2CUSTOMTRANSMIT Object Handle.
Identificador de objeto SERCX2SYSTEMDMARECEIVE
Un identificador de objeto SERCX2SYSTEMDMARECEIVE es una referencia opaca a un objeto system-DMA-receive en la versión 2 de la extensión de marco serie (SerCx2).
El método SerCx2SystemDmaReceiveCreate crea un objeto system-DMA-receive. SerCx2 usa este objeto para administrar transacciones DMA del sistema que leen datos del controlador serie. Este objeto es opaco para los controladores de controladora serie. SerCx2SystemDmaReceiveCreate proporciona, como parámetro de salida, un identificador SERCX2SYSTEMDMARECEIVE al objeto system-DMA-receive recién creado. SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en transacciones posteriores de recepción del sistema DMA. Para obtener más información, vea SerCx2 System-DMA-Receive Transactions.
Después de serCx2SystemDmaReceiveCreate crea el objeto system-DMA-receive, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo del controlador serie. El objeto system-DMA-receive se elimina automáticamente cuando se elimina el objeto de dispositivo. Un controlador de controlador de serie puede, como opción, crear un objeto system-DMA-receive, pero no puede crear más de un objeto de este tipo. El controlador solo puede crear este objeto en las condiciones siguientes:
- El controlador creó previamente un objeto pio-receive.
- El controlador no ha creado un objeto de recepción personalizado.
Para obtener más información sobre los objetos pio-receive, vea SERCX2PIORECEIVE Object Handle. Para obtener más información sobre los objetos de recepción personalizados, vea SERCX2CUSTOMRECEIVE Object Handle.
Identificador de objeto SERCX2SYSTEMDMATRANSMIT
Un identificador de objeto SERCX2SYSTEMDMATRANSMIT es una referencia opaca a un objeto system-DMA-transmit en la versión 2 de la extensión de marco serie (SerCx2).
El método SerCx2SystemDmaTransmitCreate crea un objeto system-DMA-transmit. SerCx2 usa este objeto para administrar transacciones DMA del sistema que escriben datos en el controlador serie. Este objeto es opaco para los controladores de controladora serie. SerCx2SystemDmaTransmitCreate proporciona, como parámetro de salida, un identificador SERCX2SYSTEMDMATRANSMIT al objeto system-DMA-transmit recién creado. SerCx2 y el controlador de controlador serie usan este identificador para hacer referencia al objeto en transacciones posteriores de transmisión del sistema DMA. Para obtener más información, vea SerCx2 System-DMA-Transmit Transactions.
Después de que SerCx2SystemDmaTransmitCreate crea el objeto system-DMA-transmit, este objeto existe durante la vigencia del objeto de dispositivo de marco que representa el dispositivo de controlador serie. El objeto system-DMA-transmit se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador de controlador serie no debe intentar eliminar el objeto system-DMA-transmit llamando a un método como WdfObjectDelete.
Un controlador de controlador de serie puede, como opción, crear un objeto system-DMA-transmit, pero no puede crear más de un objeto de este tipo. El controlador solo puede crear este objeto en las siguientes condiciones:</wdcml:p>
- El controlador creó previamente un objeto pio-transmit.
- El controlador no ha creado un objeto de transmisión personalizada.
Para obtener más información sobre los objetos PIO-transmit, vea SERCX2PIOTRANSMIT Object Handle. Para obtener más información sobre los objetos de transmisión personalizada, vea SERCX2CUSTOMTRANSMIT Object Handle.
Temas relacionados
SerCx2 Custom-Receive Transacciones
SerCx2 Custom-Transmit Transacciones
SerCx2 PIO-Receive Transacciones
SerCx2 PIO-Transmit Transacciones
SerCx2 System-DMA-Receive Transactions
Transacciones serCx2 System-DMA-Transmit
SerCx2CustomReceiveTransactionCreate