structure SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG (sercx.h)

Article
10/30/2024

La structure SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG contient des informations que la version 2 de l’extension de framework série (SerCx2) utilise pour configurer un nouvel objet custom-receive-transaction.

Syntaxe

typedef struct _SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG {
  ULONG                                                              Size;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_INITIALIZE                   EvtSerCx2CustomReceiveTransactionInitialize;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_START                        EvtSerCx2CustomReceiveTransactionStart;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP                      EvtSerCx2CustomReceiveTransactionCleanup;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_ENABLE_NEW_DATA_NOTIFICATION EvtSerCx2CustomReceiveTransactionEnableNewDataNotification;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_QUERY_PROGRESS               EvtSerCx2CustomReceiveTransactionQueryProgress;
} SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG, *PSERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG;

Membres

Size

Taille, en octets, de cette structure. La méthode SerCx2CustomReceiveTransactionCreate 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.

EvtSerCx2CustomReceiveTransactionInitialize

Pointeur vers la fonction de rappel d’événement EvtSerCx2CustomReceiveTransactionInitialize. Ce membre est facultatif et peut être défini sur NULL pour indiquer que le pilote n’implémente pas la fonction.

EvtSerCx2CustomReceiveTransactionStart

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

EvtSerCx2CustomReceiveTransactionCleanup

Pointeur vers la fonction de rappel d’événement evtSerCx2CustomReceiveTransactionCleanup 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.

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

Pointeur vers l’implémentation du pilote EvtSerCx2CustomReceiveTransactionEnableNewDataNotification fonction de rappel d’événement. Ce membre est facultatif et peut être défini sur NULL pour indiquer que le pilote n’implémente pas la fonction.

EvtSerCx2CustomReceiveTransactionQueryProgress

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

Remarques

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