PFREE_ADAPTER_CHANNEL fungsi panggilan balik (wdm.h)

Artikel
02/29/2024

Rutinitas FreeAdapterChannel merilis pengontrol DMA sistem ketika driver telah menyelesaikan semua operasi DMA yang diperlukan untuk memenuhi IRP saat ini.

Sintaks

PFREE_ADAPTER_CHANNEL PfreeAdapterChannel;

void PfreeAdapterChannel(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Parameter

[in] DmaAdapter

Penunjuk ke struktur DMA_ADAPTER yang dikembalikan oleh IoGetDmaAdapter yang mewakili adaptor bus-master atau pengontrol DMA.

Nilai kembali

Tidak ada

Keterangan

FreeAdapterChannel bukanlah rutinitas sistem yang dapat dipanggil langsung dengan nama. Rutinitas ini hanya dapat dipanggil oleh penunjuk dari alamat yang dikembalikan dalam struktur DMA_OPERATIONS . Driver mendapatkan alamat rutinitas ini dengan memanggil IoGetDmaAdapter.

Setelah driver mentransfer semua data dan disebut FlushAdapterBuffers, driver memanggil FreeAdapterChannel untuk merilis pengontrol DMA sistem yang sebelumnya dialokasikan dengan panggilan ke AllocateAdapterChannel.

FreeAdapterChannel membebaskan semua register peta yang dialokasikan oleh panggilan sebelumnya ke AllocateAdapterChannel. Driver memanggil rutinitas ini hanya jika rutinitas AdapterControl-nya mengembalikan KeepObject.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL	DISPATCH_LEVEL
Aturan kepatuhan DDI	IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm)