struktur SERCX_BUFFER_DESCRIPTOR (sercx.h)

Struktur SERCX_BUFFER_DESCRIPTOR menjelaskan buffer data untuk operasi penerima atau operasi pengiriman.

Sintaks

typedef struct SERCX_BUFFER_DESCRIPTOR {
  USHORT Size;
  PUCHAR Buffer;
  ULONG  Length;
} SERCX_BUFFER_DESCRIPTOR, *PSERCX_BUFFER_DESCRIPTOR;

Anggota

Size

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

Buffer

Alamat memori virtual buffer. Memori untuk buffer tidak bertumpuk.

Length

Jumlah byte yang tersedia di buffer. Ukuran ini menentukan memaksimalkan jumlah byte yang dapat ditransfer oleh operasi terima atau kirim.

Keterangan

Driver pengontrol serial menggunakan informasi dalam struktur ini untuk menentukan dari mana dalam memori untuk membaca data selama operasi penerimaan, dan di mana dalam memori untuk menulis data selama operasi pengiriman.

Kapan saja, tidak boleh ada lebih dari satu buffer penerima yang valid dan satu buffer pengiriman yang valid. Driver pengontrol memanggil metode SerCxRetrieveReceiveBuffer untuk mendapatkan buffer penerima, dan memanggil metode SerCxRetrieveTransmitBuffer untuk mendapatkan buffer transmisi. Kedua metode menyalin deskripsi buffer ke dalam struktur SERCX_BUFFER_DESCRIPTOR yang dialokasikan pemanggil. Panggilan berikutnya ke salah satu metode ini membatalkan deskriptor yang dikeluarkan sebelumnya untuk buffer penerima atau mengirimkan buffer, masing-masing. Pemanggil tidak boleh mengakses buffer yang dijelaskan oleh deskriptor buffer yang tidak lagi valid.

Buffer yang diperoleh oleh panggilan berturut-turut ke SerCxRetrieveReceiveBuffer atau SerCxRetrieveTransmitBuffer tidak dijamin berdampingan.

Driver pengontrol harus memanggil fungsi SERCX_BUFFER_DESCRIPTOR_INIT untuk menginisialisasi struktur SERCX_BUFFER_DESCRIPTOR sebelum struktur diteruskan ke metode SerCxRetrieveReceiveBuffer atau SerCxRetrieveTransmitBuffer . Setelah deskriptor buffer diinisialisasi, deskriptor dapat digunakan kembali tanpa diinisialisasi lagi.

Persyaratan

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

Lihat juga

SERCX_BUFFER_DESCRIPTOR_INIT

SerCxRetrieveReceiveBuffer

SerCxRetrieveTransmitBuffer