Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tema se describen los tipos de identificador de objeto que se definen específicamente para la versión 2 de la extensión de marco serie (SerCx2).
La interfaz de controlador de dispositivo SerCx2 (DDI) usa estos tipos de identificador 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 Kernel-Mode Driver Framework (KMDF).
Para obtener más información sobre los tipos de identificador 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
- Manejador del objeto SERCX2CUSTOMTRANSMITTRANSACTION
- Identificador de objeto SERCX2PIORECEIVE
- identificador de objeto SERCX2PIOTRANSMIT
- Manejador de Objeto SERCX2SYSTEMDMARECEIVE
- Manejador 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 de marco 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 de serie.
SerCx2CustomReceiveCreate proporciona, como parámetro de salida, un identificador de SERCX2CUSTOMRECEIVE al objeto de recepción personalizado recién creado.
SerCx2 y el controlador de serie usan este identificador para referirse al objeto en llamadas posteriores a los métodos de SerCx2 y las funciones de devolución de llamada de eventos.
Después de que SerCx2CustomReceiveCreate crea el objeto de recepción personalizada, este objeto existe durante la duración del objeto de dispositivo del marco que representa el dispositivo del controlador serial. El objeto de recepción personalizada se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador serie no debe intentar eliminar el objeto de recepción personalizada llamando a un método como WdfObjectDelete.
Un controlador de controlador serie puede, como opción, crear un objeto de recepción personalizado, 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 de recepción de PIO, consulte SERCX2PIORECEIVE Identificador de objeto.
Para obtener más información sobre los objetos system-DMA-receive, vea SERCX2SYSTEMDMARECEIVE Identificador de objetos.
identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION
Un identificador de objeto SERCX2CUSTOMRECEIVETRANSACTION es una referencia opaca a un objeto de transacción de recepción personalizada en la versión 2 de la extensión del framework de 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 de serie.
SerCx2CustomReceiveTransactionCreate proporciona, como parámetro de salida, un identificador de SERCX2CUSTOMRECEIVETRANSACTION al objeto custom-receive-transaction recién creado.
SerCx2 y el controlador de serie usan este identificador para hacer referencia al objeto en transacciones posteriores de recepción a medida.
Para obtener más información, vea SerCx2 Custom-Receive Transactions.
Después de que SerCx2CustomReceiveTransactionCreate crea el objeto de transacción de recepción personalizada, este objeto existe durante toda la duración del objeto de dispositivo de marco que representa el dispositivo controlador de serie.
El objeto custom-receive-transaction se elimina automáticamente cuando se elimina el objeto de dispositivo.
El controlador del puerto serie no debe intentar eliminar el objeto custom-receive-transaction llamando a un método como WdfObjectDelete.
Un controlador de serie puede, opcionalmente, crear un objeto de transacción de recepción personalizada, pero no puede crear más de uno.
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 de recepción de PIO, consulte el identificador de objeto SERCX2PIORECEIVE. Para obtener más información sobre los objetos de recepción personalizados, vea SERCX2CUSTOMRECEIVE Identificador de objetos.
A pesar de las vidas útiles similares de los objetos custom-receive y custom-receive-transaction, estos se definen como tipos de objeto independientes (y no combinados en un tipo) para facilitar la posible expansión futura de la interfaz del controlador de dispositivos SerCx2.
Manejador 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 en serie (SerCx2).
El método SerCx2CustomTransmitCreate crea un objeto custom-transmit.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 de dispositivos serie.
SerCx2CustomTransmitCreate proporciona, como parámetro de salida, un identificador de SERCX2CUSTOMTRANSMIT al objeto de transmisión personalizado recién creado. SerCx2 y el controlador de serie usan este identificador para referirse al objeto en llamadas posteriores a los métodos de SerCx2 y las funciones de devolución de llamada de eventos.
Después de que SerCx2CustomTransmitCreate cree el objeto de transmisión personalizada, este objeto existe mientras dure el objeto dispositivo del entorno 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 serie no debe intentar eliminar el objeto de transmisión personalizada llamando a un método como WdfObjectDelete.
Un controlador de controlador serie puede, como opción, crear un objeto de transmisión personalizado, 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 manejador de objetos. Para obtener más información sobre los objetos system-DMA-transmit, vea SERCX2SYSTEMDMATRANSMIT Identificador de objetos.
Identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION Object Handle
Un identificador de objeto SERCX2CUSTOMTRANSMITTRANSACTION es una referencia opaca a un objeto custom-transmit-transaction en la versión 2 de la extensión de marco 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 personalizado de transferencia de datos para escribir datos en el controlador serie. Este objeto es opaco para los controladores de dispositivos serie.
SerCx2CustomTransmitTransactionCreate proporciona, como parámetro de salida, un identificador de SERCX2CUSTOMTRANSMITTRANSACTION al objeto custom-transmit-transaction recién creado. SerCx2 y el controlador de bus serie utilizan este identificador para referirse al objeto en transacciones posteriores de transmisión personalizada.
Para obtener más información, vea SerCx2 Custom-Transmit Transactions.
Después de que SerCx2CustomTransmitTransactionCreate crea el objeto de transacción de transmisión personalizada, este objeto existe durante la vigencia del objeto de dispositivo de entorno que representa el dispositivo del controlador serial. 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 serie puede, como opción, crear un objeto de transmisión personalizado, 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, consulte identificador de objeto SERCX2PIOTRANSMIT. Para obtener más información sobre los objetos de transmisión personalizada, vea Identificador del objeto SERCX2CUSTOMTRANSMIT.
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 de marco 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 de dispositivos serie. proporciona, como parámetro de salida, un identificador de SERCX2PIORECEIVE al objeto de recepción de PIO recién creado. SerCx2 y el controlador de serie usan este identificador para hacer referencia al objeto en las transacciones posteriores de recepción de PIO.
Para obtener más información, vea SerCx2 PIO-Receive Transactions. Después de que SerCx2PioReceiveCreate crea el objeto PIO-receive, este objeto existe durante la vida útil del objeto de dispositivo de la plataforma que representa al dispositivo del controlador serie. El objeto PIO-receive se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador de serie no debe intentar eliminar el objeto PIO-receive llamando a un método como WdfObjectDelete.
Un controlador de serie debe crear uno y solo un objeto de recepción de PIO. El controlador debe crear este objeto antes de crear un objeto system-DMA-receive o un objeto de recepción personalizado. Para obtener más información sobre los objetos system-DMA-receive, vea SERCX2SYSTEMDMARECEIVE Identificador de objetos. Para obtener más información sobre los objetos de recepción personalizados, vea SERCX2CUSTOMRECEIVE Identificador de objetos.
Manejador 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 serie (SerCx2).
El método SerCx2PioTransmitCreate crea un objeto PIO-transmit. SerCx2 usa 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 dispositivos serie. SerCx2PioTransmitCreate proporciona, como parámetro de salida, un identificador de SERCX2PIOTRANSMIT al objeto pio-transmit recién creado. SerCx2 y el controlador serie utilizan este handle para hacer referencia al objeto en las transacciones posteriores de transmisión PIO. Para obtener más información, consulte 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 del controlador serie. El objeto PIO-transmit se elimina automáticamente cuando se elimina el objeto de dispositivo. El controlador de puerto serie no debe intentar eliminar el objeto PIO-transmit llamando a un método como WdfObjectDelete.
Un controlador 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 personalizado. Para obtener más información sobre los objetos system-DMA-transmit, vea SERCX2SYSTEMDMATRANSMIT Manejador de objetos. Para obtener más información sobre los objetos de transmisión personalizada, consulte el Identificador de objeto SERCX2CUSTOMTRANSMIT.
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 las transacciones DMA del sistema que leen datos del controlador serie. Este objeto es opaco para los controladores de dispositivos serie. SerCx2SystemDmaReceiveCreate proporciona, como parámetro de salida, un identificador de SERCX2SYSTEMDMARECEIVE al objeto system-DMA-receive recién creado. SerCx2 y el controlador del puerto serie utilizan este identificador para referirse al objeto en las transacciones de recepción de DMA del sistema posteriores. Para obtener más información, vea SerCx2 System-DMA-Receive Transactions.
Después de que SerCx2SystemDmaReceiveCreate crea el objeto de recepción de DMA del sistema, este objeto existe durante la vida útil del objeto del dispositivo del framework que representa el controlador de dispositivo serie. El objeto system-DMA-receive se elimina automáticamente cuando se elimina el objeto de dispositivo. Un controlador de controlador 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 de recepción de PIO, consulte el identificador de objeto SERCX2PIORECEIVE. Para obtener más información sobre los objetos de recepción personalizados, vea SERCX2CUSTOMRECEIVE Identificador de objetos.
SERCX2SYSTEMDMATRANSMIT identificador de objeto
Un identificador de objeto SERCX2SYSTEMDMATRANSMIT es una referencia opaca a un objeto system-DMA-transmit en la versión 2 de la extensión del marco de 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 dispositivos serie. SerCx2SystemDmaTransmitCreate proporciona, como parámetro de salida, un identificador de SERCX2SYSTEMDMATRANSMIT al objeto system-DMA-transmit recién creado. SerCx2 y el controlador de serie usan este identificador para hacer referencia al objeto en las transacciones posteriores de transmisión de DMA del sistema. Para obtener más información, vea SerCx2 System-DMA-Transmit Transactions.
Después de que SerCx2SystemDmaTransmitCreate crea el objeto de transmisión DMA del sistema, este objeto existe a lo largo de la vida útil del objeto de dispositivo de framework 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 serie no debe intentar eliminar el objeto de transmisión de DMA del sistema mediante la llamada a un método como WdfObjectDelete.
Un controlador de controlador 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 personalizable.
Para obtener más información sobre los objetos PIO-transmit, vea SERCX2PIOTRANSMIT manejador de objetos. Para obtener más información sobre los objetos de transmisión personalizada, vea SERCX2CUSTOMTRANSMIT Manejador de Objeto.
Temas relacionados
SerCx2 Custom-Receive Transacciones
SerCx2 Custom-Transmit Transacciones
SerCx2 PIO-Receive Transacciones
Transacciones SerCx2 PIO-Transmit
Sistema SerCx2-DMA-Receive Transacciones
Transacciones del Sistema SerCx2-DMA-Transmit
SerCx2CustomReceiveTransactionCreate