struktur NDIS_GENERIC_OBJECT (ndis.h)

Artikel
02/26/2024

Struktur NDIS_GENERIC_OBJECT mendefinisikan objek generik yang dapat digunakan komponen perangkat lunak untuk mendapatkan handel NDIS.

Sintaks

typedef struct _NDIS_GENERIC_OBJECT {
  NDIS_OBJECT_HEADER Header;
  PVOID              Caller;
  PVOID              CallersCaller;
  PDRIVER_OBJECT     DriverObject;
} NDIS_GENERIC_OBJECT, *PNDIS_GENERIC_OBJECT;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur objek generik (NDIS_GENERIC_OBJECT). NDIS mengatur anggota Jenis struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_GENERIC_OBJECT, anggota Revisi ke NDIS_GENERIC_OBJECT_REVISION_1, dan anggota Ukuran ke sizeof(NDIS_GENERIC_OBJECT).

Caller

Dicadangkan untuk NDIS.

CallersCaller

Dicadangkan untuk NDIS.

DriverObject

Objek driver yang terkait dengan objek generik. Jika tidak ada objek driver, anggota ini adalah NULL. Ini adalah nilai yang diteruskan pada parameter DriverObject dari Fungsi NdisAllocateGenericObject .

Keterangan

Komponen perangkat lunak yang belum memiliki NDIS menangani panggilan NdisAllocateGenericObject untuk membuat objek generik. Komponen tersebut menggunakan handel yang diperoleh dari NdisAllocateGenericObject untuk mengalokasikan sumber daya NDIS.

Parameter UkuranNdisAllocateGenericObject menentukan jumlah memori, dalam byte, untuk dicadangkan bagi pemanggil. NdisAllocateGenericObject menambahkan memori tambahan setelah anggota NDIS_OBJECT_STRUCTURE.

Sebagian besar driver NDIS tidak memerlukan objek generik untuk mendapatkan handel. Protokol NDIS, perantara, dan driver miniport mendapatkan handel selama inisialisasi.

Gunakan fungsi NdisFreeGenericObject untuk membebaskan objek generik yang dibuat dengan NdisAllocateGenericObject.