structure SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG (sercx.h)

Article
02/29/2024

La structure SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG contient des informations que la version 2 de l’extension d’infrastructure série (SerCx2) utilise pour configurer un nouvel objet de réception-transaction personnalisée.

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 versions futures du fichier d’en-tête Sercx.h.

EvtSerCx2CustomReceiveTransactionInitialize

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

EvtSerCx2CustomReceiveTransactionStart

Pointeur vers la fonction de rappel d’événement EvtSerCx2CustomReceiveTransactionStart implémentée par le pilote. 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 la fonction de rappel d’événement EvtSerCx2CustomReceiveTransactionEnableNewDataNotification 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.

EvtSerCx2CustomReceiveTransactionQueryProgress

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

Remarques

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