Fungsi SerCxRetrieveReceiveBuffer (sercx.h)
Metode SerCxRetrieveReceiveBuffer mendapatkan buffer input tempat data yang diterima dari port serial dapat dimuat.
Sintaks
NTSTATUS SerCxRetrieveReceiveBuffer(
[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 SerCxRetrieveReceiveBuffer berhasil, pemanggil menerima buffer input yang berisi hingga Panjang byte ruang yang tersedia. (Ruang yang tersedia di buffer mungkin kurang dari byte Panjang .) SerCxRetrieveReceiveBuffer menulis jumlah aktual byte ruang yang tersedia untuk anggota Panjang struktur yang ditunjukkan oleh parameter BufferDescriptor .
[in, out] BufferDescriptor
Penunjuk ke struktur SERCX_BUFFER_DESCRIPTOR yang dialokasikan pemanggil. Struktur ini menjelaskan buffer data yang akan digunakan untuk operasi penerima. Pemanggil sebelumnya memanggil fungsi SERCX_BUFFER_DESCRIPTOR_INIT untuk menginisialisasi struktur ini. SerCxRetrieveTransmitBuffer menulis ke anggota Buffer dan Panjang struktur ini.
Nilai kembali
SerCxRetrieveReceiveBuffer mengembalikan STATUS_SUCCESS jika berhasil. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode ini dipanggil pada IRQL yang salah; atau handel WDFDEVICE tidak valid; atau Perangkat atau BufferDescriptor adalah NULL; atau driver sudah memiliki buffer penerima. |
|
Ukuran yang salah ditentukan untuk struktur SERCX_BUFFER_DESCRIPTOR . |
|
Tidak dapat mengalokasikan sumber daya sistem (biasanya memori). |
Keterangan
Driver pengontrol serial memanggil metode ini untuk memperoleh buffer untuk memuat data input dari operasi terima (baca) 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk