struktur SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG (sercx.h)

Artikel
08/07/2023

Struktur SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG berisi informasi yang digunakan ekstensi kerangka kerja serial (SerCx2) versi 2 untuk mengonfigurasi objek transaksi penerimaan kustom baru.

Sintaks

typedef struct _SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG {
  ULONG                                                              Size;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_INITIALIZE                   EvtSerCx2CustomReceiveTransactionInitialize;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_START                        EvtSerCx2CustomReceiveTransactionStart;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP                      EvtSerCx2CustomReceiveTransactionCleanup;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_ENABLE_NEW_DATA_NOTIFICATION EvtSerCx2CustomReceiveTransactionEnableNewDataNotification;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_QUERY_PROGRESS               EvtSerCx2CustomReceiveTransactionQueryProgress;
} SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG, *PSERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG;

Anggota

Size

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

EvtSerCx2CustomReceiveTransactionInitialize

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2CustomReceiveTransactionInitialize yang diimplementasikan driver. Anggota ini bersifat opsional dan dapat diatur ke NULL untuk menunjukkan bahwa driver tidak mengimplementasikan fungsi.

EvtSerCx2CustomReceiveTransactionStart

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

EvtSerCx2CustomReceiveTransactionCleanup

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2CustomReceiveTransactionCleanup yang diimplementasikan driver. Anggota ini bersifat opsional dan dapat diatur ke NULL untuk menunjukkan bahwa driver tidak mengimplementasikan fungsi.

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

Penunjuk ke fungsi panggilan balik peristiwa EvtSerCx2CustomReceiveTransactionEnableNewDataNotification yang diimplementasikan driver. Anggota ini bersifat opsional dan dapat diatur ke NULL untuk menunjukkan bahwa driver tidak mengimplementasikan fungsi.

EvtSerCx2CustomReceiveTransactionQueryProgress

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

Keterangan

Metode SerCx2CustomReceiveTransactionCreate menerima pointer ke struktur SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG sebagai parameter input. Sebelum memanggil SerCx2CustomReceiveTransactionInitialize, panggil fungsi SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG_INIT untuk menginisialisasi struktur ini.