Bagikan melalui

Fungsi SerCxProgressReceive (sercx.h)

  • Artikel

Metode SerCxProgressReceive melaporkan kemajuan operasi baca (terima) saat ini.

Sintaks

NTSTATUS SerCxProgressReceive(
  [in] WDFDEVICE    Device,
  [in] ULONG        BytesReceived,
  [in] SERCX_STATUS ReceiveStatus
);

Parameter

[in] Device

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

[in] BytesReceived

Jumlah byte data yang dimuat pemanggil ke dalam buffer penerima yang diperoleh dengan panggilan terbaru ke metode SerCxRetrieveReceiveBuffer .

[in] ReceiveStatus

Status operasi penerima saat ini. Atur parameter ini ke salah satu nilai berikut:

  • SerCxStatusSuccess
  • SerCxStatusCancelled
  • SerCxStatusTimeout
Untuk informasi selengkapnya tentang nilai-nilai ini, lihat SERCX_STATUS.

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 Nilai BytesReceived melebihi panjang buffer yang tersedia; atau nilai ReceiveStatus tidak valid.
STATUS_INVALID_DEVICE_REQUEST
 Metode ini dipanggil pada IRQL yang salah; atau handel WDFDEVICE tidak valid; atau driver belum mendapatkan buffer input untuk operasi penerima ini.
STATUS_CANCELLED
 Operasi terima telah dibatalkan.

Keterangan

Driver pengontrol serial memanggil metode ini untuk melaporkan kemajuan pada operasi baca yang luar biasa. Biasanya, driver pengontrol serial memanggil metode ini dari panggilan balik penyelesaian DMA-nya (jika driver menggunakan DMA untuk membaca data) atau dari fungsi DPC pengiriman/penerimaannya (jika PIO digunakan).

Jika SerCxProgressReceive tidak menyelesaikan semua pekerjaan yang luar biasa untuk operasi baca, pemanggil harus memanggil metode SerCxRetrieveReceiveBuffer lagi untuk mendapatkan deskriptor buffer baru dan terus menerima data.

Persyaratan

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

Lihat juga

SERCX_STATUS

SerCxRetrieveReceiveBuffer