struktur SERCX2_PIO_TRANSMIT_CONFIG (sercx.h)

Artikel
08/07/2023

Struktur SERCX2_PIO_TRANSMIT_CONFIG berisi informasi yang digunakan ekstensi kerangka kerja serial (SerCx2) versi 2 untuk mengonfigurasi objek transmisi PIO baru.

Sintaks

typedef struct _SERCX2_PIO_TRANSMIT_CONFIG {
  ULONG                                             Size;
  PFN_SERCX2_PIO_TRANSMIT_INITIALIZE_TRANSACTION    EvtSerCx2PioTransmitInitializeTransaction;
  PFN_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION       EvtSerCx2PioTransmitCleanupTransaction;
  PFN_SERCX2_PIO_TRANSMIT_WRITE_BUFFER              EvtSerCx2PioTransmitWriteBuffer;
  PFN_SERCX2_PIO_TRANSMIT_ENABLE_READY_NOTIFICATION EvtSerCx2PioTransmitEnableReadyNotification;
  PFN_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION EvtSerCx2PioTransmitCancelReadyNotification;
  PFN_SERCX2_PIO_TRANSMIT_DRAIN_FIFO                EvtSerCx2PioTransmitDrainFifo;
  PFN_SERCX2_PIO_TRANSMIT_CANCEL_DRAIN_FIFO         EvtSerCx2PioTransmitCancelDrainFifo;
  PFN_SERCX2_PIO_TRANSMIT_PURGE_FIFO                EvtSerCx2PioTransmitPurgeFifo;
} SERCX2_PIO_TRANSMIT_CONFIG, *PSERCX2_PIO_TRANSMIT_CONFIG;

Anggota

Size

Ukuran, dalam byte, dari struktur ini. Metode SerCx2PioTransmitCreate 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.

EvtSerCx2PioTransmitInitializeTransaction

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitInitializeTransaction yang diimplementasikan driver. Anggota ini harus menunjuk ke fungsi yang valid.

EvtSerCx2PioTransmitCleanupTransaction

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitCleanupTransaction yang diimplementasikan driver. Anggota ini harus menunjuk ke fungsi yang valid.

EvtSerCx2PioTransmitWriteBuffer

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitWriteBuffer yang diimplementasikan driver. Anggota ini harus menunjuk ke fungsi yang valid.

EvtSerCx2PioTransmitEnableReadyNotification

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitEnableReadyNotification yang diimplementasikan driver. Anggota ini harus menunjuk ke fungsi yang valid.

EvtSerCx2PioTransmitCancelReadyNotification

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitCancelReadyNotification yang diimplementasikan driver. Anggota ini harus menunjuk ke fungsi yang valid.

EvtSerCx2PioTransmitDrainFifo

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitDrainFifo yang diimplementasikan driver. Anggota ini bersifat opsional dan dapat diatur ke NULL untuk menunjukkan bahwa driver tidak mengimplementasikan fungsi. Namun, driver yang mengimplementasikan fungsi ini juga harus menerapkan fungsi EvtSerCx2PioTransmitCancelDrainFifo dan EvtSerCx2PioTransmitPurgeFifo .

EvtSerCx2PioTransmitCancelDrainFifo

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitCancelDrainFifo yang diimplementasikan driver. Anggota ini bersifat opsional dan dapat diatur ke NULL untuk menunjukkan bahwa driver tidak mengimplementasikan fungsi. Namun, driver yang mengimplementasikan fungsi ini juga harus menerapkan fungsi EvtSerCx2PioTransmitDrainFifo dan EvtSerCx2PioTransmitPurgeFifo .

EvtSerCx2PioTransmitPurgeFifo

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2PioTransmitPurgeFifo yang diimplementasikan driver. Anggota ini bersifat opsional dan dapat diatur ke NULL untuk menunjukkan bahwa driver tidak mengimplementasikan fungsi. Namun, driver yang mengimplementasikan fungsi ini juga harus menerapkan fungsi EvtSerCx2PioTransmitDrainFifo dan EvtSerCx2PioTransmitCancelDrainFifo .

Keterangan

Metode SerCx2PioTransmitCreate menerima pointer ke struktur SERCX2_PIO_TRANSMIT_CONFIG sebagai parameter input. Sebelum memanggil SerCx2PioTransmitCreate, panggil fungsi SERCX2_PIO_TRANSMIT_CONFIG_INIT untuk menginisialisasi struktur ini.