Makro NdisMCompleteDmaTransfer (ndis.h)

Artikel
02/26/2024

Fungsi NdisMCompleteDmaTransfer menunjukkan bahwa operasi transfer DMA sistem telah selesai. Ini mengatur ulang pengontrol DMA sistem sebagai persiapan untuk transfer DMA lebih lanjut.

Sintaks

void NdisMCompleteDmaTransfer(
   _S,
   _H,
   _B,
   _O,
   _L,
   _M_
);

Parameter

_S

Penunjuk ke variabel yang disediakan penelepon di mana fungsi ini mengembalikan status akhir transfer DMA, yang dapat menjadi salah satu hal berikut:

NDIS_STATUS_SUCCESS

Data telah ditransfer dan dibersihkan ke memori host atau ke perangkat untuk menjaga integritas data.

NDIS_STATUS_RESOURCES

Pengontrol DMA dirilis tetapi transfer data mungkin tidak melekat.

_H

Handel ditampilkan ketika fungsi MiniportInitializeEx yang disebut Fungsi NdisMRegisterDmaChannel .

_B

Penunjuk ke deskriptor buffer yang sebelumnya diteruskan ke NdisMSetupDmaTransfer.

_O

Offset byte di mana transfer dimulai. Nilai ini juga diteruskan ke NdisMSetupDmaTransfer.

_L

Panjang dalam byte transfer. Nilai ini juga diteruskan ke NdisMSetupDmaTransfer.

_M_

TRUE jika transfer berasal dari host ke NIC, seperti, misalnya, operasi pengiriman.

Nilai kembali

Tidak ada

Keterangan

NdisMCompleteDmaTransfer harus dipanggil dengan WriteToDevice diatur ke TRUE sebelum data yang ditransfer dianggap ada dalam memori NIC. NdisMCompleteDmaTransfer harus dipanggil dengan WriteToDevice diatur ke FALSE sebelum data yang ditransfer dapat dibaca dari memori host.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisMCompleteDmaTransfer (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisMCompleteDmaTransfer (NDIS 5.1)) di Windows XP.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_MCO_Function(ndis)