structure SERCX2_PIO_TRANSMIT_CONFIG (sercx.h)

Article
10/30/2024

La structure SERCX2_PIO_TRANSMIT_CONFIG contient des informations que la version 2 de l’extension de framework série (SerCx2) utilise pour configurer un nouvel objet de transmission PIO.

Syntaxe

typedef struct _SERCX2_PIO_TRANSMIT_CONFIG {
  ULONG                                             Size;
  PFN_SERCX2_PIO_TRANSMIT_INITIALIZE_TRANSACTION    EvtSerCx2PioTransmitInitializeTransaction;
  PFN_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION       EvtSerCx2PioTransmitCleanupTransaction;
  PFN_SERCX2_PIO_TRANSMIT_WRITE_BUFFER              EvtSerCx2PioTransmitWriteBuffer;
  PFN_SERCX2_PIO_TRANSMIT_ENABLE_READY_NOTIFICATION EvtSerCx2PioTransmitEnableReadyNotification;
  PFN_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION EvtSerCx2PioTransmitCancelReadyNotification;
  PFN_SERCX2_PIO_TRANSMIT_DRAIN_FIFO                EvtSerCx2PioTransmitDrainFifo;
  PFN_SERCX2_PIO_TRANSMIT_CANCEL_DRAIN_FIFO         EvtSerCx2PioTransmitCancelDrainFifo;
  PFN_SERCX2_PIO_TRANSMIT_PURGE_FIFO                EvtSerCx2PioTransmitPurgeFifo;
} SERCX2_PIO_TRANSMIT_CONFIG, *PSERCX2_PIO_TRANSMIT_CONFIG;

Membres

Size

Taille, en octets, de cette structure. La méthode SerCx2PioTransmitCre ate utilise ce membre pour déterminer la version de la structure utilisée par l’appelant. La taille de cette structure peut changer dans les futures versions du fichier d’en-tête Sercx.h.

EvtSerCx2PioTransmitInitializeTransaction

Pointeur vers la fonction de rappel d’événements EvtSerCx2PioTransmitInitializeTransaction. Ce membre doit pointer vers une fonction valide.

EvtSerCx2PioTransmitCleanupTransaction

Pointeur vers la fonction de rappel d’événement implémentée par le pilote EvtSerCx2PioTransmitCleanupTransaction fonction de rappel d’événement. Ce membre doit pointer vers une fonction valide.

EvtSerCx2PioTransmitWriteBuffer

Pointeur vers la fonction de rappel d’événement evtSerCx2PioTransmitWriteBuffer implémentée par le pilote. Ce membre doit pointer vers une fonction valide.

EvtSerCx2PioTransmitEnableReadyNotification

Pointeur vers la fonction de rappel d’événement evtSerCx2PioTransmitEnableReadyNotification implémentée par le pilote. Ce membre doit pointer vers une fonction valide.

EvtSerCx2PioTransmitCancelReadyNotification

Pointeur vers la fonction de rappel d’événement evtSerCx2PioTransmitCancelReadyNotification implémentée par le pilote. Ce membre doit pointer vers une fonction valide.

EvtSerCx2PioTransmitDrainFifo

Pointeur vers la fonction de rappel d’événements EvtSerCx2PioTransmitDrainFifo. Ce membre est facultatif et peut être défini sur NULL pour indiquer que le pilote n’implémente pas la fonction. Toutefois, un pilote qui implémente cette fonction doit également implémenter fonctions EvtSerCx2PioTransmitCancelDrainFifo et EvtSerCx2PioTransmitPurgeFifo.

EvtSerCx2PioTransmitCancelDrainFifo

Pointeur vers la fonction de rappel d’événement evtSerCx2PioTransmitCancelDrainFifo implémentée par le pilote. Ce membre est facultatif et peut être défini sur NULL pour indiquer que le pilote n’implémente pas la fonction. Toutefois, un pilote qui implémente cette fonction doit également implémenter fonctions EvtSerCx2PioTransmitDrainFifo et EvtSerCx2PioTransmitPurgeFifo.

EvtSerCx2PioTransmitPurgeFifo

Pointeur vers la fonction de rappel d’événement implémentée par le pilote EvtSerCx2PioTransmitPurgeFifo. Ce membre est facultatif et peut être défini sur NULL pour indiquer que le pilote n’implémente pas la fonction. Toutefois, un pilote qui implémente cette fonction doit également implémenter EvtSerCx2PioTransmitDrainFifo et EvtSerCx2PioTransmitCancelDrainFifo fonctions.

Remarques

La méthode SerCx2PioTransmitCreate accepte un pointeur vers une structure SERCX2_PIO_TRANSMIT_CONFIG en tant que paramètre d’entrée. Avant d’appeler SerCx2PioTransmitCreate, appelez la fonction SERCX2_PIO_TRANSMIT_CONFIG_INIT pour initialiser cette structure.