Fungsi NetDmaProviderStop (netdma.h)

Artikel
02/29/2024

Catatan Antarmuka NetDMA tidak didukung

di Windows 8 dan yang lebih baru.

Fungsi NetDmaProviderStop memberi tahu antarmuka NetDMA bahwa semua saluran DMA yang terkait dengan penyedia DMA tidak lagi tersedia untuk transfer DMA.

Sintaks

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Parameter

[in] NetDmaProviderHandle

Handel yang mengidentifikasi penyedia DMA. Driver penyedia DMA menerima handel ini dari antarmuka NetDMA dalam panggilan ke Fungsi NetDmaRegisterProvider .

Nilai kembali

Tidak ada

Keterangan

Driver penyedia DMA memanggil fungsi NetDmaProviderStop untuk memberi tahu antarmuka NetDMA bahwa mesin DMA, yang dimulai dengan memanggil fungsi NetDmaProviderStart , tidak lagi tersedia.

Driver penyedia DMA harus memanggil NetDmaProviderStop sebelum memanggil fungsi NetDmaDeregisterProvider untuk membatalkan pendaftaran penyedia DMA.

Driver penyedia DMA biasanya memanggil NetDmaProviderStop saat menangani IRP IRP_MN_REMOVE_DEVICE atau IRP_MN_STOP_DEVICE .

Driver penyedia DMA dapat memanggil NetDmaProviderStop dan NetDmaProviderStart sebanyak yang diperlukan aplikasi setelah mendaftarkan penyedia DMA dan sebelum membatalkan pendaftaran penyedia DMA. Jika mesin DMA sedang dimulai ulang setelah disebut NetDmaProviderStop, driver penyedia DMA dapat menentukan atribut baru di NET_DMA_PROVIDER_ATTRIBUTES struktur di parameter ProviderAttributes dari NetDmaProviderStart.

Antarmuka NetDMA menunggu operasi DMA yang luar biasa selesai dan membebaskan semua saluran DMA yang dialokasikan sebelum kembali dari fungsi NetDmaProviderStop .

Persyaratan

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