structure SERCX_CONFIG (sercx.h)

Article
12/15/2024

La structure SERCX_CONFIG contient des informations de configuration pour l’extension de framework 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 futures versions 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 définie sur WdfTrue, la file d’attente du contrôleur doit être gérée par l’alimentation. Si la valeur est définie sur WdfFalse, la file d’attente du contrôleur n’est pas gérée par l’alimentation. Si la valeur est définie sur 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 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 est requis pour pointer vers une fonction de rappel valide.

EvtSerCxReceive

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

EvtSerCxWaitmask

Pointeur vers la fonction de rappel EvtSerCxWaitmask du pilote de contrôleur. Ce membre est requis pour 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 est requis pour pointer vers une fonction de rappel valide.

EvtSerCxApplyConfig

Pointeur vers la fonction de rappel EvtSerCxApplyConfig du pilote de contrôleur. Ce membre est requis pour 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 du contrôleur pour définir les pointeurs de fonction de rappel et le membre PowerManaged.