struttura SERCX_CONFIG (sercx.h)

Articolo
12/15/2024

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;

Membri

Size

Dimensione, in byte, di questa struttura. Il metodo SerCxInitialize utilizza questo membro per determinare la versione della struttura utilizzata dal chiamante. Le dimensioni di questa struttura potrebbero cambiare nelle versioni future del file di intestazione Sercx.h.

PowerManaged

Indica 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 modo energetico, 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 al driver del controller EvtSerCxFileOpen funzione di callback. Questo membro è facoltativo e può essere impostato su NULL.

EvtSerCxFileClose

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

EvtSerCxFileCleanup

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

EvtSerCxTransmit

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

EvtSerCxReceive

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

EvtSerCxWaitmask

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

EvtSerCxPurge

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

EvtSerCxControl

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

EvtSerCxApplyConfig

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

EvtSerCxTransmitCancel

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

EvtSerCxReceiveCancel

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

Osservazioni

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 di funzione di callback e il membro PowerManaged.