Bagikan melalui


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
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 penerima.
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 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

SERCX_BUFFER_DESCRIPTOR

SERCX_BUFFER_DESCRIPTOR_INIT