Bagikan melalui

Fungsi SerCxRetrieveTransmitBuffer (sercx.h)

  • Artikel

Metode SerCxRetrieveTransmitBuffer mendapatkan buffer output yang berisi data yang siap untuk ditransmisikan ke port serial.

Sintaks

NTSTATUS SerCxRetrieveTransmitBuffer(
  [in]      WDFDEVICE                Device,
  [in]      ULONG                    Length,
  [in, out] PSERCX_BUFFER_DESCRIPTOR BufferDescriptor
);

Parameter

[in] Device

Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial.

[in] Length

Panjang buffer yang diminta, dalam byte. Jika panggilan SerCxRetrieveTransmitBuffer berhasil, pemanggil menerima buffer output yang berisi hingga Panjang byte data yang tersedia. (Data yang tersedia dalam buffer mungkin kurang dari Byte panjang .) SerCxRetrieveTransmitBuffer menulis jumlah byte aktual dari data yang tersedia ke anggota Panjang struktur yang ditunjukkan oleh parameter BufferDescriptor .

[in, out] BufferDescriptor

Penunjuk ke struktur SERCX_BUFFER_DESCRIPTOR yang dialokasikan penelepon. Struktur ini menjelaskan buffer data yang akan digunakan untuk operasi pengiriman. Penelepon sebelumnya memanggil fungsi SERCX_BUFFER_DESCRIPTOR_INIT untuk menginisialisasi struktur ini. SerCxRetrieveTransmitBuffer menulis ke anggota Buffer dan Panjang struktur ini.

Nilai kembali

SerCxRetrieveTransmitBuffer mengembalikan STATUS_SUCCESS jika berhasil. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Menampilkan kode Deskripsi
STATUS_INVALID_DEVICE_REQUEST
 Metode ini dipanggil pada IRQL yang salah; atau handel WDFDEVICE tidak valid; atau Perangkat atau BufferDescriptor adalah NULL; atau driver sudah memiliki buffer transmisi.
STATUS_INFO_LENGTH_MISMATCH
 Ukuran yang salah ditentukan untuk struktur SERCX_BUFFER_DESCRIPTOR .
STATUS_INSUFFICIENT_RESOURCES
 Tidak dapat mengalokasikan sumber daya sistem (biasanya memori).

Keterangan

Driver pengontrol serial memanggil metode ini untuk memperoleh buffer yang berisi data output untuk operasi transmisi (tulis) saat ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 8.
Target Platform Universal
Header sercx.h
IRQL <= DISPATCH_LEVEL

Lihat juga

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT