REMOTE_NDIS_PACKET_MSG

REMOTE_NDIS_PACKET_MSG merangkum paket data NDIS untuk membentuk satu pesan data.

Menggabungkan beberapa elemen REMOTE_NDIS_PACKET_MSG membentuk pesan multipaket. Setiap komponen REMOTE_NDIS_PACKET_MSG individu dibangun seperti yang dijelaskan di bawah ini. Perbedaan dari pesan paket tunggal adalah bahwa bidang MessageLength di setiap header REMOTE_NDIS_PACKET_MSG menyertakan beberapa byte padding tambahan. Byte padding ini ditambahkan ke semua kecuali REMOTE_NDIS_PACKET_MSG terakhir sehingga REMOTE_NDIS_PACKET_MSG yang berhasil dimulai pada batas byte yang sesuai. Untuk pesan yang dikirim dari perangkat ke host, padding ini harus mengakibatkan setiap REMOTE_NDIS_PACKET_MSG dimulai dari offset byte yang merupakan kelipatan 8 byte mulai dari awal pesan multipaket. Ketika host mengirim pesan multipaket ke perangkat, host akan mematuhi PacketAlignmentFactor yang ditentukan perangkat.

Format REMOTE_NDIS_PACKET_MSG ditentukan dalam tabel berikut.

Offset	Ukuran	Bidang	Deskripsi
0	4	MessageType	Menentukan jenis pesan yang sedang dikirim. Atur ke 0x1.
4	4	MessageLength	Panjang pesan dalam byte, termasuk data paket tambahan, data OOB, data informasi per paket, dan padding internal dan eksternal.
8	4	DataOffset	Menentukan offset dalam byte dari awal bidang DataOffset pesan ini hingga awal data. Ini adalah kelipatan bilangan bulat dari 4.
12	4	DataLength	Menentukan jumlah byte dalam konten data pesan ini.
16	4	OOBDataOffset	Menentukan offset dalam byte rekaman data OOB pertama dari awal bidang DataOffset pesan ini. Atur ke nol jika tidak ada data OOB. Jika tidak, ini adalah kelipatan bilangan bulat 4.
20	4	OOBDataLength	Menentukan dalam byte panjang total data OOB.
24	4	NumOOBDataElements	Menentukan jumlah rekaman OOB dalam pesan ini.
28	4	PerPacketInfoOffset	Menentukan dalam byte offset dari awal bidang DataOffset dalam pesan data REMOTE_NDIS_PACKET_MSG hingga awal rekaman data informasi per paket pertama. Atur ke nol jika tidak ada data per paket. Jika tidak, ini adalah kelipatan bilangan bulat 4.
32	4	PerPacketInfoLength	Menentukan dalam byte panjang total informasi per paket yang terkandung dalam pesan ini.
36	4	VcHandle	Dicadangkan untuk perangkat berorientasi koneksi. Atur ke nol.
40	4	Dicadangkan	Dicadangkan. Atur ke nol.

Format rekaman data OOB tunggal ditunjukkan dalam tabel berikut.

Offset	Ukuran	Bidang	Deskripsi
0	4	Ukuran	Panjang byte header OOB ini dan data OOB tambahan dan padding. Ini adalah kelipatan bilangan bulat dari 4.
4	4	Jenis	Tidak ada yang ditentukan untuk perangkat 802.3.
8	4	ClassInformationOffset	Offset byte dari awal rekaman data OOB ini hingga awal data OOB.
(N)	...	OOB Data	Data OOB; lihat dokumentasi Microsoft Windows Driver Development Kit (DDK) untuk informasi selengkapnya.

Catatan (N) sama dengan nilai ClassInformationOffset.

Tabel berikut menentukan format rekaman data informasi per paket.

Offset	Ukuran	Bidang	Deskripsi
0	4	Ukuran	Panjang byte header per paket ini dan menambahkan data per paket dan padding. Nilai ini adalah kelipatan bilangan bulat 4.
4	4	Jenis	Atur ke salah satu nilai hukum untuk NDIS_PER_PACKET_INFO_FROM_PACKET, seperti yang dijelaskan dalam Windows 2000 Driver Development Kit (DDK).
8	4	PerPacketInformationOffset	Offset byte dari awal rekaman data informasi per paket ini ke awal data informasi per paket.
(N)	...	Data Per-Packet	data Per-Packet; lihat dokumentasi Windows 2000 DDK untuk informasi selengkapnya.

Catatan (N) sama dengan nilai PerPacketInformationOffset.

Keterangan

Setiap REMOTE_NDIS_PACKET_MSG mungkin berisi satu atau beberapa rekaman data OOB. NumOOBDataElements menunjukkan jumlah rekaman data OOB dalam pesan ini. Rekaman data OOB harus muncul secara berurutan. Bidang OOBDataLength menunjukkan panjang byte dari seluruh blok data OOB. Bidang OOBDataOffset menunjukkan offset byte dari awal bidang DataOffset ke awal blok data OOB. Untuk informasi selengkapnya tentang data paket OOB, lihat spesifikasi NDIS di Windows 2000 DDK.

Jika beberapa blok data OOB dilampirkan ke pesan REMOTE_NDIS_PACKET_MSG, setiap rekaman data OOB berikutnya harus segera mengikuti data rekaman OOB sebelumnya.

Tidak ada informasi OOB yang saat ini ditentukan untuk perangkat 802.3.

Setiap REMOTE_NDIS_PACKET_MSG mungkin berisi satu atau beberapa rekaman data per-info paket. Per-packet-info digunakan untuk menyampaikan metadata paket, seperti checksum TCP. Bidang PerPacketInfoOffset menunjukkan offset byte dari awal bidang DataOffset ke awal rekaman data informasi per paket. Bidang OOBDataLength menunjukkan panjang byte rekaman data informasi per paket. Untuk informasi selengkapnya tentang data informasi per paket, lihat Windows 2000 DDK.

Jika ada beberapa blok data informasi per paket, setiap catatan data informasi per paket berikutnya harus segera mengikuti data rekaman informasi per paket sebelumnya.

Perangkat NDIS Jarak Jauh harus mengirim dan menerima data melalui paket data NDIS. Bus yang digunakan perangkat menentukan bagaimana paket ini diteruskan dari host ke perangkat dan perangkat ke host. Ini bisa berupa memori bersama atau, dalam kasus USB, Isoch, dan Pipa massal. Paket NDIS juga dapat berisi data out-of-band (OOB) serta data yang melintasi jaringan.

Perangkat NDIS Jarak Jauh mentransfer paket NDIS, dienkapsulasi sebagai REMOTE_NDIS_PACKET_MSG di seluruh saluran data. Perangkat tanpa koneksi (seperti 802.3) dan perangkat berorientasi koneksi (seperti ATM) menggunakan struktur pesan paket yang sama untuk memfasilitasi kode umum untuk pemrosesan paket. Setiap pesan REMOTE_NDIS_PACKET_MSG berisi informasi tentang satu unit data jaringan (seperti bingkai Ethernet 802.3).

Untuk informasi selengkapnya tentang data paket out-of-band atau data per info paket, lihat bagian NDIS Windows 2000 DDK.

Persyaratan

Versi	Tersedia di Microsoft Windows XP dan versi sistem operasi Windows yang lebih baru. Juga tersedia di Windows 2000 sebagai biner yang dapat didistribusikan ulang.
Header	Rndis.h (termasuk Rndis.h)