struktur SERCX_CONFIG (sercx.h)

Artikel
08/07/2023

Struktur SERCX_CONFIG berisi informasi konfigurasi untuk ekstensi kerangka kerja serial (SerCx).

Sintaks

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;

Anggota

Size

Ukuran, dalam byte, dari struktur ini. Metode SerCxInitialize menggunakan anggota ini untuk menentukan versi struktur mana yang digunakan pemanggil. Ukuran struktur ini mungkin berubah dalam versi file header Sercx.h yang akan datang.

PowerManaged

Apakah antrean pengontrol harus dikelola daya. Jika diatur ke WdfTrue, antrean pengontrol harus dikelola daya. Jika diatur ke WdfFalse, antrean pengontrol tidak dikelola daya. Jika diatur ke WdfDefault, antrean pengontrol harus dikelola daya kecuali driver memanggil metode WdfFdoInitSetFilter . Untuk informasi selengkapnya, lihat deskripsi anggota PowerManaged di WDF_IO_QUEUE_CONFIG.

EvtSerCxFileOpen

Penunjuk ke fungsi panggilan balik EvtSerCxFileOpen driver pengontrol. Anggota ini bersifat opsional dan dapat diatur ke NULL.

EvtSerCxFileClose

Penunjuk ke fungsi panggilan balik EvtSerCxFileClose driver pengontrol. Anggota ini bersifat opsional dan dapat diatur ke NULL.

EvtSerCxFileCleanup

Penunjuk ke fungsi panggilan balik EvtSerCxFileCleanup driver pengontrol. Anggota ini bersifat opsional dan dapat diatur ke NULL.

EvtSerCxTransmit

Penunjuk ke fungsi panggilan balik EvtSerCxTransmit driver pengontrol. Anggota ini diperlukan untuk menunjuk ke fungsi panggilan balik yang valid.

EvtSerCxReceive

Penunjuk ke fungsi panggilan balik EvtSerCxReceive driver pengontrol. Anggota ini diperlukan untuk menunjuk ke fungsi panggilan balik yang valid.

EvtSerCxWaitmask

Penunjuk ke fungsi panggilan balik EvtSerCxWaitmask driver pengontrol. Anggota ini diperlukan untuk menunjuk ke fungsi panggilan balik yang valid.

EvtSerCxPurge

Penunjuk ke fungsi panggilan balik EvtSerCxPurge driver pengontrol. Anggota ini bersifat opsional dan dapat diatur ke NULL.

EvtSerCxControl

Penunjuk ke fungsi panggilan balik EvtSerCxControl driver pengontrol . Anggota ini diperlukan untuk menunjuk ke fungsi panggilan balik yang valid.

EvtSerCxApplyConfig

Penunjuk ke fungsi panggilan balik EvtSerCxApplyConfig driver pengontrol. Anggota ini diperlukan untuk menunjuk ke fungsi panggilan balik yang valid.

EvtSerCxTransmitCancel

Penunjuk ke fungsi panggilan balik EvtSerCxTransmitCancel driver pengontrol. Anggota ini bersifat opsional dan dapat diatur ke NULL.

EvtSerCxReceiveCancel

Penunjuk ke fungsi panggilan balik EvtSerCxReceiveCancel driver pengontrol. Anggota ini bersifat opsional dan dapat diatur ke NULL.

Keterangan

Sebelum struktur ini diteruskan ke metode SerCxInitialize , struktur ini harus diinisialisasi oleh fungsi SERCX_CONFIG_INIT , dan kemudian dimodifikasi oleh driver pengontrol untuk mengatur penunjuk fungsi panggilan balik dan anggota PowerManaged .