PFREE_COMMON_BUFFER fungsi panggilan balik (wdm.h)

Artikel
08/08/2023

Rutinitas FreeCommonBuffer membebaskan buffer umum yang dialokasikan oleh AllocateCommonBuffer, bersama dengan semua sumber daya yang digunakan buffer.

Sintaks

PFREE_COMMON_BUFFER PfreeCommonBuffer;

void PfreeCommonBuffer(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] ULONG Length,
  [in] PHYSICAL_ADDRESS LogicalAddress,
  [in] PVOID VirtualAddress,
  [in] BOOLEAN CacheEnabled
)
{...}

Parameter

[in] DmaAdapter

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

[in] Length

Menentukan jumlah byte yang akan dibatalkan alokasinya.

[in] LogicalAddress

Menentukan alamat logis dari rentang memori yang dialokasikan.

[in] VirtualAddress

Arahkan ke alamat virtual yang sesuai dari rentang memori yang dialokasikan.

[in] CacheEnabled

Menunjukkan apakah memori yang dialokasikan di-cache.

Nilai kembali

Tidak ada

Keterangan

FreeCommonBuffer 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.

Untuk merilis buffer umum, driver memanggil FreeCommonBuffer untuk membuka peta alamat logis dan virtualnya. Parameter yang diteruskan ke FreeCommonBuffer harus sama persis dengan yang diteruskan ke dan dikembalikan dari AllocateCommonBuffer. Driver tidak dapat membebaskan bagian dari buffer umum yang dialokasikan.

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	PASSIVE_LEVEL
Aturan kepatuhan DDI	IrqlDispatch(wdm)

Lihat juga