struktur SERCX2_CUSTOM_RECEIVE_CONFIG (sercx.h)

Artikel
08/07/2023

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

Sintaks

typedef struct _SERCX2_CUSTOM_RECEIVE_CONFIG {
  ULONG   Size;
  ULONG   Alignment;
  ULONG   MinimumTransactionLength;
  ULONG   MaximumTransactionLength;
  ULONG   MinimumTransferUnit;
  BOOLEAN Exclusive;
} SERCX2_CUSTOM_RECEIVE_CONFIG, *PSERCX2_CUSTOM_RECEIVE_CONFIG;

Anggota

Size

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

Alignment

Persyaratan perataan data. Menentukan bagaimana alamat awal transfer dalam transaksi penerima kustom harus diselaraskan dalam memori. Atur anggota ini ke konstanta FILE_XXX_ALIGNMENT yang sesuai dalam file header Wdm.h. Misalnya, FILE_WORD_ALIGNMENT menunjukkan bahwa alamat awal harus diselaraskan dengan batas dua byte dalam memori, FILE_LONG_ALIGNMENT menunjukkan bahwa alamat harus diselaraskan dengan batas empat byte, dan sebagainya.

MinimumTransactionLength

Panjang minimum, dalam byte, dari transfer data dalam transaksi penerima kustom. Jika panjang buffer dalam permintaan baca (IRP_MJ_READ) kurang dari panjang minimum ini, SerCx2 menggunakan I/O terprogram (PIO) untuk transaksi.

MaximumTransactionLength

Panjang maksimum, dalam byte, dari transfer data dalam transaksi penerima kustom. Jika ukuran buffer dalam permintaan baca lebih besar dari panjang maksimum ini, SerCx2 menggunakan beberapa transaksi penerima kustom untuk menangani permintaan, dan membatasi setiap transaksi hingga panjang maksimum.

MinimumTransferUnit

Unit transfer minimum. Jumlah byte yang ditentukan oleh elemen dalam daftar sebar/kumpulkan harus berupa kelipatan bilangan bulat dari unit transfer minimum. Untuk menunjukkan bahwa unit transfer minimum default harus digunakan, atur anggota ini ke nol. Untuk informasi selengkapnya tentang unit transfer minimum default, lihat DMA_ADAPTER_INFO_V1.

Exclusive

Apakah akan menggunakan transaksi penerima kustom secara eksklusif untuk menangani permintaan tulis (IRP_MJ_READ). Atur ke TRUE untuk menunjukkan bahwa permintaan baca harus menggunakan transaksi penerimaan kustom secara eksklusif. Atur ke FALSE untuk menunjukkan bahwa permintaan baca dapat menggunakan kombinasi transaksi penerima kustom dan transaksi penerima PIO.

Atur anggota ini ke TRUE hanya jika unit transfer minimum untuk transaksi penerimaan kustom adalah satu byte, panjang transaksi minimum adalah satu byte, dan buffer baca untuk transaksi dapat dimulai pada batas byte apa pun dalam memori.

Jika EksklusifTRUE, anggota MinimumTransferUnitOverride, Alignment, dan MinimumTransactionLength harus nol.

Terlepas dari nilai anggota ini, transaksi yang diterima PIO digunakan untuk menyimpan data yang belum dibaca dalam FIFO penerima sebelum pengontrol serial keluar dari status daya perangkat D0 untuk memasuki status daya rendah.

Keterangan

Metode SerCx2CustomReceiveCreate menerima pointer ke struktur SERCX2_CUSTOM_RECEIVE_CONFIG sebagai parameter input. Sebelum memanggil SerCx2CustomReceiveCreate, panggil fungsi SERCX2_CUSTOM_RECEIVE_CONFIG_INIT untuk menginisialisasi struktur ini.