Fungsi VideoPortAllocatePool (video.h)

Artikel
08/07/2023

Fungsi VideoPortAllocatePool mengalokasikan blok memori kumpulan, memasukkan tag yang disediakan penelepon di awal memori.

Sintaks

VIDEOPORT_API PVOID VideoPortAllocatePool(
  [in] IN PVOID        HwDeviceExtension,
  [in] IN VP_POOL_TYPE PoolType,
  [in] IN SIZE_T       NumberOfBytes,
  [in] IN ULONG        Tag
);

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] PoolType

Menentukan jenis kumpulan memori yang akan dialokasikan. Parameter ini dapat diatur ke salah satu hal berikut:

Nilai	Makna
VpNonPagedPool	Kumpulan berasal dari memori yang tidak dipagasi.
VpPagedPool	Kumpulan berasal dari memori halaman.
VpNonPagedPoolCacheAligned	Kumpulan ini berasal dari memori yang selaras dengan cache dan tidak dipagasi.
VpPagedPoolCacheAligned	Kumpulan ini berasal dari memori halaman yang selaras dengan cache.

[in] NumberOfBytes

Menentukan jumlah byte memori yang akan dialokasikan.

[in] Tag

Menentukan tag alokasi empat byte, yang terdiri dari hingga empat karakter ASCII, yang secara unik mengidentifikasi driver yang mengalokasikan memori. String tag dibatasi dengan tanda kutip tunggal.

Nilai kembali

Pada alokasi kumpulan memori yang berhasil, VideoPortAllocatePool mengembalikan alamat kumpulan memori yang dialokasikan. Jika tidak, fungsi ini mengembalikan NULL.

Keterangan

VideoPortAllocatePool dimaksudkan untuk menggantikan VideoPortAllocateBuffer, yang kedaluwarsa.

String Tag harus ditentukan dalam urutan byte-reversed. Disarankan agar huruf pertama dalam string (sebelum dibalik) menjadi 'D' untuk menunjukkan driver tampilan; tiga byte lainnya harus menunjukkan nama driver. Misalnya, string Tag 'zyxD' muncul sebagai 'Dxyz' jika kumpulan dicadangkan. Tag muncul di crash dump sistem yang terjadi.

Pemanggil VideoPortAllocatePool dapat berjalan di IRQL = DISPATCH_LEVEL hanya jika PoolType yang diminta adalah salah satu jenis VpNonPagedXxx . Jika tidak, penelepon harus berjalan di IRQL < DISPATCH_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	Lihat bagian Keterangan.

Lihat juga

VideoPortFreePool

Bagikan melalui