Fungsi NdisAllocateGenericObject (ndis.h)

Komponen yang tidak memiliki handel NDIS menggunakan fungsi NdisAllocateGenericObject untuk mengalokasikan objek NDIS generik.

Sintaks

PNDIS_GENERIC_OBJECT NdisAllocateGenericObject(
  [optional] PDRIVER_OBJECT DriverObject,
             ULONG          Tag,
             USHORT         Size
);

Parameter

[optional] DriverObject

Objek driver untuk dikaitkan dengan objek generik. Parameter ini bisa NULL.

Tag

Tag memori kernel yang harus digunakan NDIS untuk mengalokasikan memori untuk objek generik.

Size

Jumlah memori, dalam byte, untuk dicadangkan bagi pemanggil. Ini tidak termasuk ukuran struktur NDIS_GENERIC_OBJECT . Gunakan ruang memori tambahan untuk tujuan Anda sendiri. Untuk mengakses memori tambahan, gunakan sizeof(NDIS_GENERIC_OBJECT) untuk melewati struktur objek generik.

Nilai kembali

NdisAllocateGenericObject mengembalikan pointer ke NDIS_GENERIC_OBJECT yang dialokasikan. Jika NDIS gagal membuat objek, nilai yang dikembalikan adalah NULL.

Keterangan

NDIS menggunakan objek generik untuk mengelola sumber daya yang dialokasikan oleh komponen yang tidak memiliki handel NDIS. Komponen seperti itu menggunakan penunjuk objek generik yang dikembalikan sebagai handel NDIS di beberapa API alokasi sumber daya NDIS yang memerlukan handel NDIS.

Driver NDIS harus memanggil fungsi NdisFreeGenericObject untuk membebaskan objek generik yang dibuat dengan NdisAllocateGenericObject.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis), NdisAllocateGenericObject(ndis)

Lihat juga

NDIS_GENERIC_OBJECT

NdisFreeGenericObject