DMA_RESET_HANDLER fungsi panggilan balik (netdma.h)

Catatan Antarmuka NetDMA tidak didukung

di Windows 8 dan yang lebih baru.

 

Fungsi ProviderResetChannel mengatur ulang saluran DMA ke status awal yang ada setelah saluran DMA dialokasikan.

Sintaks

DMA_RESET_HANDLER DmaResetHandler;

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

ProviderResetChannel 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 ProviderResetChannel adalah fungsi opsional untuk penyedia NetDMA. Antarmuka NetDMA memanggil fungsi ProviderResetChannel driver penyedia DMA, jika ada, untuk mengatur ulang saluran DMA.

Di ProviderResetChannel, penyedia NetDMA harus segera mengakhiri transfer aktif 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 reset selesai, saluran DMA harus dalam status awal yang ada setelah saluran dialokasikan. Setelah antarmuka NetDMA memanggil ProviderResetChannel, penyedia DMA tidak dapat mengakses salah satu deskriptor DMA yang dikirimkan sebelumnya. Saluran DMA harus siap untuk antarmuka NetDMA untuk memanggil fungsi ProviderStartDma .

NetDMA memanggil ProviderResetChannel 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

ProviderStartDma