estructura SERCX_CONFIG (sercx.h)

Artículo
12/13/2024

La estructura SERCX_CONFIG contiene información de configuración para la extensión de marco serie (SerCx).

Sintaxis

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;

Miembros

Size

Tamaño, en bytes, de esta estructura. El método SerCxInitialize usa este miembro para determinar qué versión de la estructura usa el autor de la llamada. El tamaño de esta estructura puede cambiar en versiones futuras del archivo de encabezado Sercx.h.

PowerManaged

Si la cola del controlador debe administrarse con energía. Si se establece en WdfTrue, la cola del controlador debe administrarse con energía. Si se establece en WdfFalse, la cola del controlador no se administra con energía. Si se establece en WdfDefault, la cola del controlador debe administrarse a menos que el controlador llame al método WdfFdoInitSetFilter. Para obtener más información, consulte la descripción del miembro de powerManaged en WDF_IO_QUEUE_CONFIG.

EvtSerCxFileOpen

Puntero al controlador EvtSerCxFileOpen función de devolución de llamada. Este miembro es opcional y se puede establecer en NULL.

EvtSerCxFileClose

Puntero al controlador EvtSerCxFileClose función de devolución de llamada. Este miembro es opcional y se puede establecer en NULL.

EvtSerCxFileCleanup

Puntero al controlador EvtSerCxFileCleanup función de devolución de llamada. Este miembro es opcional y se puede establecer en NULL.

EvtSerCxTransmit

Puntero al controlador EvtSerCxTransmit función de devolución de llamada. Este miembro es necesario para apuntar a una función de devolución de llamada válida.

EvtSerCxReceive

Puntero a la función de devolución de llamada EvtSerCxReceive del controlador. Este miembro es necesario para apuntar a una función de devolución de llamada válida.

EvtSerCxWaitmask

Puntero al controlador EvtSerCxWaitmask función de devolución de llamada. Este miembro es necesario para apuntar a una función de devolución de llamada válida.

EvtSerCxPurge

Puntero al controlador EvtSerCxPurge función de devolución de llamada. Este miembro es opcional y se puede establecer en NULL.

EvtSerCxControl

Puntero a la función de devolución de llamada EvtSerCx Control del controlador. Este miembro es necesario para apuntar a una función de devolución de llamada válida.

EvtSerCxApplyConfig

Puntero al controlador EvtSerCxApplyConfig función de devolución de llamada. Este miembro es necesario para apuntar a una función de devolución de llamada válida.

EvtSerCxTransmitCancel

Puntero al del controlador EvtSerCxTransmitCancel función de devolución de llamada. Este miembro es opcional y se puede establecer en NULL.

EvtSerCxReceiveCancel

Puntero al controlador EvtSerCxReceiveCancel función de devolución de llamada. Este miembro es opcional y se puede establecer en NULL.

Observaciones

Antes de pasar esta estructura al método SerCxInitialize, la función de SERCX_CONFIG_INIT debe inicializarla y, a continuación, modificarla para establecer los punteros de función de devolución de llamada y el miembro PowerManaged.