DMA_SUSPEND_HANDLER fungsi panggilan balik (netdma.h)

Catatan Antarmuka NetDMA tidak didukung

di Windows 8 dan yang lebih baru.

 

Fungsi ProviderSuspendDma menangguhkan transfer DMA yang saat ini sedang berlangsung di saluran DMA.

Sintaks

DMA_SUSPEND_HANDLER DmaSuspendHandler;

NTSTATUS DmaSuspendHandler(
  [in]  PVOID ProviderChannelContext,
  [out] PPHYSICAL_ADDRESS *pLastDescriptor
)
{...}

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 .

[out] pLastDescriptor

Penunjuk ke variabel yang berisi alamat fisik deskriptor DMA terakhir yang berhasil diproses. Penyedia DMA menyediakan alamat ini sebelum kembali dari ProviderSuspendDma.

Nilai kembali

ProviderSuspendDma 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 ProviderSuspendDma adalah fungsi opsional untuk penyedia NetDMA. Antarmuka NetDMA dapat memanggil fungsi ProviderSuspendDma , jika ada, untuk menangguhkan sementara transfer DMA yang sedang berlangsung di saluran DMA.

Penyedia DMA menyelesaikan transfer deskriptor DMA saat ini sebelum kembali dari ProviderSuspendDma. Jika pelaporan status penyelesaian diaktifkan, mesin DMA menulis status NetDmaTransferStatusSuspend di alamat yang ditentukan dalam anggota CompletionVirtualAddress dan CompletionPhysicalAddress di NET_DMA_CHANNEL_PARAMETERS struktur.

Saat transfer DMA ditangguhkan, antarmuka NetDMA dapat mengubah daftar tertaut deskriptor DMA (misalnya, untuk menyisipkan atau menghapus deskriptor).

Antarmuka NetDMA memanggil fungsi ProviderResumeDma untuk melanjutkan operasi DMA yang ditangguhkan dengan memanggil ProviderSuspendDma.

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

ProviderResumeDma