DMA_ABORT_HANDLER fungsi panggilan balik (netdma.h)
di Windows 8 dan yang lebih baru.
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 |
|---|---|
|
Operasi berhasil diselesaikan. |
|
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 |