struktur SERCX2_CUSTOM_TRANSMIT_CONFIG (sercx.h)

  • Artikel

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

Sintaks

typedef struct _SERCX2_CUSTOM_TRANSMIT_CONFIG {
  ULONG   Size;
  ULONG   Alignment;
  ULONG   MinimumTransactionLength;
  ULONG   MaximumTransactionLength;
  ULONG   MinimumTransferUnit;
  BOOLEAN Exclusive;
} SERCX2_CUSTOM_TRANSMIT_CONFIG, *PSERCX2_CUSTOM_TRANSMIT_CONFIG;

Anggota

Size

Ukuran, dalam byte, dari struktur ini. Metode SerCx2CustomTransmitCreate 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 penyelarasan data. Menentukan bagaimana alamat awal transfer dalam transaksi pengiriman 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 pengiriman kustom. Jika panjang buffer dalam permintaan tulis (IRP_MJ_WRITE) kurang dari panjang minimum ini, SerCx2 menggunakan I/O (PIO) terprogram untuk transaksi.

MaximumTransactionLength

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

MinimumTransferUnit

Unit transfer minimum. Jumlah byte yang akan ditransfer dalam transaksi pengiriman kustom harus merupakan 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 pengiriman kustom secara eksklusif untuk menangani permintaan tulis (IRP_MJ_WRITE). Atur ke TRUE untuk menunjukkan bahwa permintaan tulis harus menggunakan transaksi pengiriman kustom secara eksklusif. Atur ke FALSE untuk menunjukkan bahwa permintaan tulis dapat menggunakan kombinasi transaksi pengiriman kustom dan transaksi pengiriman PIO.

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

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

Keterangan

Metode SerCx2CustomTransmitCreate menerima pointer ke struktur SERCX2_CUSTOM_TRANSMIT_CONFIG sebagai parameter input. Sebelum memanggil SerCx2CustomTransmitCreate, panggil fungsi SERCX2_CUSTOM_TRANSMIT_CONFIG_INIT untuk menginisialisasi struktur ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 8.1.
Header sercx.h

Lihat juga

DMA_ADAPTER_INFO_V1

IRP_MJ_WRITE

SERCX2_CUSTOM_TRANSMIT_CONFIG_INIT

SerCx2CustomTransmitCreate