SERCX_CONFIG structure (sercx.h)

Article
03/01/2024

La structure SERCX_CONFIG contient des informations de configuration pour l’extension d’infrastructure série (SerCx).

Syntaxe

typedef struct _SERCX_CONFIG {
  ULONG                     Size;
  WDF_TRI_STATE             PowerManaged;
  PFN_SERCX_FILEOPEN        EvtSerCxFileOpen;
  PFN_SERCX_FILECLOSE       EvtSerCxFileClose;
  PFN_SERCX_FILECLEANUP     EvtSerCxFileCleanup;
  PFN_SERCX_TRANSMIT        EvtSerCxTransmit;
  PFN_SERCX_RECEIVE         EvtSerCxReceive;
  PFN_SERCX_WAITMASK        EvtSerCxWaitmask;
  PFN_SERCX_PURGE           EvtSerCxPurge;
  PFN_SERCX_CONTROL         EvtSerCxControl;
  PFN_SERCX_APPLY_CONFIG    EvtSerCxApplyConfig;
  PFN_SERCX_TRANSMIT_CANCEL EvtSerCxTransmitCancel;
  PFN_SERCX_RECEIVE_CANCEL  EvtSerCxReceiveCancel;
} SERCX_CONFIG, *PSERCX_CONFIG;

Membres

Size

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

PowerManaged

Indique si la file d’attente du contrôleur doit être gérée par l’alimentation. Si la valeur est WdfTrue, la file d’attente du contrôleur doit être gérée par l’alimentation. Si la valeur est WdfFalse, la file d’attente du contrôleur n’est pas gérée par l’alimentation. Si la valeur est WdfDefault, la file d’attente du contrôleur doit être gérée par l’alimentation, sauf si le pilote appelle la méthode WdfFdoInitSetFilter . Pour plus d’informations, consultez la description du membre PowerManaged dans WDF_IO_QUEUE_CONFIG.

EvtSerCxFileOpen

Pointeur vers la fonction de rappel EvtSerCxFileOpen du pilote de contrôleur. Ce membre est facultatif et peut être défini sur NULL.

EvtSerCxFileClose

Pointeur vers la fonction de rappel EvtSerCxFileClose du pilote de contrôleur. Ce membre est facultatif et peut être défini sur NULL.

EvtSerCxFileCleanup

Pointeur vers la fonction de rappel EvtSerCxFileCleanup du pilote de contrôleur. Ce membre est facultatif et peut être défini sur NULL.

EvtSerCxTransmit

Pointeur vers la fonction de rappel EvtSerCxTransmit du pilote de contrôleur. Ce membre doit pointer vers une fonction de rappel valide.

EvtSerCxReceive

Pointeur vers la fonction de rappel EvtSerCxReceive du pilote du contrôleur. Ce membre doit pointer vers une fonction de rappel valide.

EvtSerCxWaitmask

Pointeur vers la fonction de rappel EvtSerCxWaitmask du pilote de contrôleur. Ce membre doit pointer vers une fonction de rappel valide.

EvtSerCxPurge

Pointeur vers la fonction de rappel EvtSerCxPurge du pilote de contrôleur. Ce membre est facultatif et peut être défini sur NULL.

EvtSerCxControl

Pointeur vers la fonction de rappel EvtSerCxControl du pilote de contrôleur. Ce membre doit pointer vers une fonction de rappel valide.

EvtSerCxApplyConfig

Pointeur vers la fonction de rappel EvtSerCxApplyConfig du pilote de contrôleur. Ce membre doit pointer vers une fonction de rappel valide.

EvtSerCxTransmitCancel

Pointeur vers la fonction de rappel EvtSerCxTransmitCancel du pilote de contrôleur. Ce membre est facultatif et peut être défini sur NULL.

EvtSerCxReceiveCancel

Pointeur vers la fonction de rappel EvtSerCxReceiveCancel du pilote de contrôleur. Ce membre est facultatif et peut être défini sur NULL.

Remarques

Avant de passer cette structure à la méthode SerCxInitialize , elle doit être initialisée par la fonction SERCX_CONFIG_INIT , puis modifiée par le pilote de contrôleur pour définir les pointeurs de fonction de rappel et le membre PowerManaged .