Fungsi SerCxRetrieveReceiveMdl (sercx.h)

Metode SerCxRetrieveReceiveMdl mengambil MDL yang menjelaskan buffer yang akan digunakan untuk menerima blok data input berikutnya.

Sintaks

NTSTATUS SerCxRetrieveReceiveMdl(
  [in]  WDFDEVICE Device,
  [out] PMDL      *Mdl
);

Parameter

[in] Device

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

[out] Mdl

Penunjuk ke lokasi tempat metode menulis pointer ke MDL.

Nilai kembali

SerCxRetrieveReceiveMdl mengembalikan STATUS_SUCCESS jika panggilan berhasil. Nilai yang mungkin dikembalikan termasuk kode kesalahan berikut.

Menampilkan kode

Deskripsi

STATUS_INVALID_DEVICE_REQUEST

Nilai ini dikembalikan jika salah satu hal berikut ini terjadi: Tidak ada permintaan terima yang luar biasa untuk mendapatkan MDL dari. Jumlah byte saat ini yang diterima (seperti yang dilaporkan oleh metode SerCxProgressReceive ) tidak sama dengan nol. Buffer telah diambil (dan panggilan yang sesuai ke metode SerCxProgressReceive belum terjadi). MDL telah diambil (dan panggilan yang sesuai ke metode SerCxProgressReceive belum terjadi).

Keterangan

Driver pengontrol serial memanggil fungsi ini untuk mendapatkan MDL yang akan digunakan untuk operasi terima (baca) saat ini. MDL menjelaskan memori buffer tempat driver mentransfer data yang diterima. Driver adalah pemilik eksklusif MDL ini sampai memanggil metode SerCxProgressReceive , setelah itu pointer MDL tidak valid dan driver tidak boleh lagi mencoba mengakses MDL atau memori buffer yang dijelaskan MDL.

Untuk informasi selengkapnya tentang MDL, lihat Menggunakan MDL.

Persyaratan

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

Lihat juga

SerCxProgressReceive