Bagikan melalui

Struktur NET_BUFFER_LIST

  • Artikel

Struktur NET_BUFFER_LIST mengemas daftar struktur NET_BUFFER yang ditautkan.

Gambar berikut menunjukkan bidang dalam struktur NET_BUFFER_LIST.

Diagram yang mengilustrasikan bidang dalam struktur NET_BUFFER_LIST.

Struktur NET_BUFFER_LIST mencakup struktur NET_BUFFER_LIST_HEADER di anggota NetBufferListHeader . Struktur NET_BUFFER_LIST_HEADER mencakup struktur NET_BUFFER_LIST_DATA di anggota NetBufferListData . Anda harus menggunakan makro NDIS untuk mengakses NET_BUFFER_LIST anggota struktur. Untuk informasi selengkapnya tentang makro ini, lihat halaman referensi struktur NET_BUFFER_LIST .

Beberapa anggota hanya digunakan oleh NDIS. Anggota yang kemungkinan besar akan digunakan driver didefinisikan dalam daftar berikut:

ParentNetBufferList
Jika struktur NET_BUFFER_LIST adalah anak yang berasal dari induk (dikloning, terfragmentasi, atau disusun ulang), ParentNetBufferList menentukan penunjuk ke struktur NET_BUFFER_LIST induk. Jika tidak, parameter ini adalah NULL.

NdisPoolHandle
Menentukan handel kumpulan yang mengidentifikasi kumpulan NET_BUFFER_LIST tempat struktur NET_BUFFER_LIST dialokasikan.

ProtocolReserved
Dicadangkan untuk digunakan oleh driver protokol.

MiniportReserved
Disediakan untuk digunakan oleh driver miniport.

SourceHandle
Handel yang diberikan NDIS kepada driver dalam operasi pengikatan atau pemasangan dengan menggunakan salah satu rutinitas yang disediakan driver berikut:

Miniport Driver
MiniportInitializeEx

Driver Protokol
ProtocolBindAdapterEx

Filter Driver
FilterAttach

NDIS menggunakan SourceHandle untuk mengembalikan struktur NET_BUFFER_LIST ke driver yang mengirim struktur NET_BUFFER_LIST. Driver NDIS tidak boleh membaca handel ini.

ChildRefCount
Jika struktur NET_BUFFER_LIST adalah induk (memiliki anak yang diturunkan oleh operasi kloning, fragmen, atau bentuk ulang), ChildRefCount menentukan jumlah anak yang ada. Jika tidak, parameter ini adalah nol.

Bendera
Dicadangkan untuk spesifikasi atribut di masa mendatang untuk struktur NET_BUFFER_LIST. Saat ini tidak ada bendera yang tersedia untuk driver.

Kondisi
Menentukan status penyelesaian akhir operasi data jaringan untuk struktur NET_BUFFER_LIST ini. Driver Miniport menulis nilai ini sebelum menyelesaikan operasi pengiriman.

NetBufferListInfo
Menentukan informasi struktur NET_BUFFER_LIST yang umum untuk semua struktur NET_BUFFER dalam daftar. Informasi ini sering disebut sebagai "data out-of-band (OOB)."

Berikutnya
Menentukan penunjuk ke struktur NET_BUFFER_LIST berikutnya dalam daftar struktur NET_BUFFER_LIST yang ditautkan. Jika struktur NET_BUFFER_LIST adalah struktur terakhir dalam daftar, anggota ini adalah NULL.

FirstNetBuffer
Menentukan penunjuk ke struktur NET_BUFFER pertama dalam daftar struktur NET_BUFFER tertaut yang terkait dengan struktur NET_BUFFER_LIST ini.

Konteks Catatan adalah penunjuk ke struktur NET_BUFFER_LIST_CONTEXT. NDIS menyediakan makro dan fungsi untuk memanipulasi data di Context . Untuk informasi selengkapnya tentang struktur NET_BUFFER_LIST_CONTEXT, lihat Struktur NET_BUFFER_LIST_CONTEXT.