SERCX_CONFIG struttura (sercx.h)

Articolo
08/07/2023

La struttura SERCX_CONFIG contiene informazioni di configurazione per l'estensione del framework seriale (SerCx).

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura. Il metodo SerCxInitialize usa questo membro per determinare quale versione della struttura sta usando il chiamante. Le dimensioni di questa struttura potrebbero cambiare nelle versioni future del file di intestazione Sercx.h.

PowerManaged

Se la coda del controller deve essere gestita dall'alimentazione. Se impostato su WdfTrue, la coda del controller deve essere gestita dall'alimentazione. Se impostato su WdfFalse, la coda del controller non è gestita dall'alimentazione. Se impostato su WdfDefault, la coda del controller deve essere gestita in modalità power, a meno che il driver non chiami il metodo WdfFdoInitSetFilter . Per altre informazioni, vedere la descrizione del membro PowerManaged in WDF_IO_QUEUE_CONFIG.

EvtSerCxFileOpen

Puntatore alla funzione di callback EvtSerCxFileOpen del driver del controller. Questo membro è facoltativo e può essere impostato su NULL.

EvtSerCxFileClose

Puntatore alla funzione di callback EvtSerCxFileClose del driver del controller. Questo membro è facoltativo e può essere impostato su NULL.

EvtSerCxFileCleanup

Puntatore alla funzione di callback EvtSerCxFileCleanup del driver del controller. Questo membro è facoltativo e può essere impostato su NULL.

EvtSerCxTransmit

Puntatore alla funzione di callback EvtSerCxTransmit del driver del controller. Questo membro è necessario per puntare a una funzione di callback valida.

EvtSerCxReceive

Puntatore alla funzione di callback EvtSerCxReceive del driver del controller. Questo membro è necessario per puntare a una funzione di callback valida.

EvtSerCxWaitmask

Puntatore alla funzione di callback evtSerCxWaitmask del driver del controller. Questo membro è necessario per puntare a una funzione di callback valida.

EvtSerCxPurge

Puntatore alla funzione di callback EvtSerCxPurge del driver del controller. Questo membro è facoltativo e può essere impostato su NULL.

EvtSerCxControl

Puntatore alla funzione di callback EvtSerCxControl del driver del controller. Questo membro è necessario per puntare a una funzione di callback valida.

EvtSerCxApplyConfig

Puntatore alla funzione di callback EvtSerCxApplyConfig del driver del controller. Questo membro è necessario per puntare a una funzione di callback valida.

EvtSerCxTransmitCancel

Puntatore alla funzione di callback EvtSerCxTransmitCancel del driver del controller. Questo membro è facoltativo e può essere impostato su NULL.

EvtSerCxReceiveCancel

Puntatore alla funzione di callback EvtSerCxReceiveCancel del driver del controller. Questo membro è facoltativo e può essere impostato su NULL.

Commenti

Prima che questa struttura venga passata al metodo SerCxInitialize , deve essere inizializzata dalla funzione SERCX_CONFIG_INIT e quindi modificata dal driver del controller per impostare i puntatori delle funzioni di callback e il membro PowerManaged .