Fungsi SerCxRetrieveTransmitMdl (sercx.h)

Metode SerCxRetrieveTransmitMdl mengambil MDL yang menjelaskan buffer yang berisi blok data output berikutnya yang akan ditransmisikan.

Sintaks

NTSTATUS SerCxRetrieveTransmitMdl(
  [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

SerCxRetrieveTransmitMdl 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 pengiriman yang luar biasa untuk mendapatkan MDL dari. Jumlah byte yang dikirimkan saat ini (seperti yang dilaporkan oleh metode SerCxProgressTransmit ) tidak sama dengan nol. Buffer telah diambil (dan panggilan yang sesuai ke metode SerCxProgressTransmit belum terjadi). MDL telah diambil (dan panggilan yang sesuai ke metode SerCxProgressTransmit belum terjadi).

Keterangan

Driver pengontrol serial memanggil fungsi ini untuk mendapatkan MDL yang akan digunakan untuk operasi transmisi (tulis) saat ini. MDL menjelaskan memori buffer tempat driver mendapatkan data yang akan ditransmisikan. Driver adalah pemilik eksklusif MDL ini sampai memanggil metode SerCxProgressTransmit , 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

SerCxProgressTransmit