DMA_ABORT_HANDLER fungsi panggilan balik (netdma.h)

Catatan Antarmuka NetDMA tidak didukung

di Windows 8 dan yang lebih baru.

 

Fungsi ProviderAbortDma membatalkan transfer DMA apa pun yang terkait dengan saluran DMA.

Sintaks

DMA_ABORT_HANDLER DmaAbortHandler;

NTSTATUS DmaAbortHandler(
  [in] PVOID ProviderChannelContext
)
{...}

Parameter

[in] ProviderChannelContext

Pointer yang mengidentifikasi area konteks saluran DMA. Penyedia DMA mengembalikan handel ini ke NetDMA di lokasi yang ditentukan dalam parameter pProviderChannelContext Fungsi ProviderAllocateDmaChannel .

Nilai kembali

ProviderAbortDma mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Operasi berhasil diselesaikan.
STATUS_UNSUCCESSFUL	Operasi gagal karena alasan yang tidak ditentukan.

Keterangan

Fungsi ProviderAbortDma adalah fungsi opsional untuk penyedia NetDMA. Antarmuka NetDMA dapat memanggil fungsi ProviderAbortDma driver penyedia DMA, jika ada, untuk membatalkan semua transfer DMA yang telah dijadwalkan pada saluran DMA.

Di ProviderAbortDma, penyedia DMA harus segera mengakhiri transfer tanpa menyelesaikan transfer data yang terkait dengan deskriptor DMA saat ini. Jika pelaporan status penyelesaian diaktifkan, mesin DMA menulis status NetDmaTransferStatusHalted di alamat yang ditentukan dalam anggota CompletionVirtualAddress dan CompletionPhysicalAddress di NET_DMA_CHANNEL_PARAMETERS struktur.

Setelah operasi batalkan selesai, saluran DMA harus siap untuk antarmuka NetDMA untuk memanggil fungsi ProviderStartDma . Antarmuka NetDMA tidak akan memanggil fungsi ProviderAppendDma sampai setelah transfer dimulai ulang.

NetDMA memanggil ProviderAbortDma di IRQL <= DISPATCH_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NetDMA 1.0 di Windows Vista.
Target Platform	Windows
Header	netdma.h (termasuk Netdma.h)
IRQL	<= DISPATCH_LEVEL

Lihat juga

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderAppendDma

ProviderStartDma