struktur NDIS_PM_PROTOCOL_OFFLOAD (ntddndis.h)
Struktur NDIS_PM_PROTOCOL_OFFLOAD menentukan parameter untuk offload protokol daya rendah ke adaptor jaringan.
Sintaks
typedef struct _NDIS_PM_PROTOCOL_OFFLOAD {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
ULONG Priority;
NDIS_PM_PROTOCOL_OFFLOAD_TYPE ProtocolOffloadType;
NDIS_PM_COUNTED_STRING FriendlyName;
ULONG ProtocolOffloadId;
ULONG NextProtocolOffloadOffset;
union {
struct {
ULONG Flags;
UCHAR RemoteIPv4Address[4];
UCHAR HostIPv4Address[4];
UCHAR MacAddress[6];
} IPv4ARPParameters;
struct {
ULONG Flags;
UCHAR RemoteIPv6Address[16];
UCHAR SolicitedNodeIPv6Address[16];
UCHAR MacAddress[6];
UCHAR TargetIPv6Addresses[2][16];
} IPv6NSParameters;
struct {
ULONG Flags;
UCHAR KCK[DOT11_RSN_KCK_LENGTH];
UCHAR KEK[DOT11_RSN_KEK_LENGTH];
ULONGLONG KeyReplayCounter;
} Dot11RSNRekeyParameters;
struct {
ULONG Flags;
ULONGLONG KeyReplayCounter;
ULONG AuthAlgo;
ULONG KCKLength;
ULONG KEKLength;
UCHAR KCK[DOT11_RSN_MAX_CIPHER_KEY_LENGTH];
UCHAR KEK[DOT11_RSN_MAX_CIPHER_KEY_LENGTH];
} Dot11RSNRekeyParametersV2;
} ProtocolOffloadParameters;
_PROTOCOL_OFFLOAD_PARAMETERS _PROTOCOL_OFFLOAD_PARAMETERS;
} NDIS_PM_PROTOCOL_OFFLOAD, *PNDIS_PM_PROTOCOL_OFFLOAD;
Anggota
Header
Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_PM_PROTOCOL_OFFLOAD . Driver mengatur anggota Tipe ke NDIS_OBJECT_TYPE_DEFAULT.
Untuk menunjukkan versi struktur NDIS_PM_PROTOCOL_OFFLOAD , atur anggota RevisiHeader ke salah satu nilai berikut:
NDIS_PM_PROTOCOL_OFFLOAD_REVISION_2
Menambahkan struktur Dot11RSNRekeyParametersV2 untuk NDIS 6.84.
Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_PM_PROTOCOL_OFFLOAD_REVISION_2.
NDIS_PM_PROTOCOL_OFFLOAD_REVISION_1
Versi asli untuk NDIS 6.20 dan yang lebih baru.
Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_PM_PROTOCOL_OFFLOAD_REVISION_1.
Flags
Nilai ULONG yang berisi bitwise OR dari bendera. Anggota ini dicadangkan untuk NDIS.
Priority
Nilai ULONG yang berisi prioritas offload protokol. Jika driver yang terlalu berlebihan menambahkan offload protokol prioritas yang lebih tinggi ketika tidak ada sumber daya yang tersedia untuk lebih banyak offload protokol, NDIS mungkin menghapus offload protokol prioritas yang lebih rendah ke sumber daya bebas. Driver miniport harus mengabaikan anggota ini. Driver protokol dapat memberikan nilai apa pun dalam rentang yang telah ditentukan sebelumnya. Nilai berikut telah ditentukan sebelumnya:
NDIS_PM_PROTOCOL_OFFLOAD_PRIORITY_LOWEST
Menentukan offload protokol prioritas terendah.
NDIS_PM_PROTOCOL_OFFLOAD_PRIORITY_NORMAL
Menentukan offload protokol prioritas normal.
NDIS_PM_PROTOCOL_OFFLOAD_PRIORITY_HIGHEST
Menentukan offload protokol prioritas tertinggi.
ProtocolOffloadType
Kartu NDIS_PM_PROTOCOL_OFFLOAD_TYPE nilai yang berisi jenis offload protokol.
FriendlyName
Struktur NDIS_PM_COUNTED_STRING yang berisi deskripsi yang dapat dibaca pengguna dari offload protokol daya rendah.
ProtocolOffloadId
Nilai ULONG yang berisi nilai yang disediakan NDIS yang mengidentifikasi protokol yang dibongkar. Sebelum NDIS mengirimkan permintaan OID OID_PM_ADD_PROTOCOL_OFFLOAD ke driver NDIS yang mendasar atau menyelesaikan permintaan ke driver yang terlalu berlebihan, NDIS mengatur ProtocolOffloadId ke nilai yang unik di antara offload protokol pada adaptor jaringan.
NextProtocolOffloadOffset
Nilai ULONG yang berisi offset, dalam byte. Anggota NextProtocolOffloadOffset dari setiap struktur NDIS_PM_PROTOCOL_OFFLOAD dalam daftar diatur ke offset (dari awal permintaan OID InformationBuffer) dari struktur NDIS_PM_PROTOCOL_OFFLOAD berikutnya dalam daftar. Jika NextProtocolOffloadOffset nol, struktur saat ini adalah struktur terakhir dalam daftar.
ProtocolOffloadParameters
Serikat yang berisi struktur anggota berikut:
ProtocolOffloadParameters.IPv4ARPParameters
Struktur yang berisi parameter ARP IPv4. Struktur ini berisi anggota berikut:
ProtocolOffloadParameters.IPv4ARPParameters.Flags
Nilai ULONG yang berisi bitwise OR dari bendera. Anggota ini dicadangkan untuk NDIS.
ProtocolOffloadParameters.IPv4ARPParameters.RemoteIPv4Address[4]
Array UCHAR yang berisi alamat IPv4 opsional. Alamat ini mewakili bidang Alamat Protokol Sumber (SPA) dari permintaan ARP.
Jika permintaan ARP masuk memiliki nilai SPA yang cocok dengan alamat IPv4 ini, adaptor jaringan mengirimkan respons ARP saat dalam status daya rendah. Jika anggota ini nol, adaptor jaringan harus merespons permintaan ARP dari alamat IPv4 jarak jauh mana pun.
Untuk informasi selengkapnya tentang protokol ARP, lihat RFC 826.
ProtocolOffloadParameters.IPv4ARPParameters.HostIPv4Address[4]
Array UCHAR yang berisi alamat IPv4. Ketika mengirimkan respons ARP, adaptor jaringan menggunakan anggota ini untuk bidang SPA respons.
ProtocolOffloadParameters.IPv4ARPParameters.MacAddress[6]
Array UCHAR yang berisi alamat kontrol akses media (MAC). Adaptor jaringan menggunakan alamat MAC ini untuk bidang Alamat Perangkat Keras Sumber (SHA) dari paket respons ARP yang dihasilkannya.
ProtocolOffloadParameters.IPv6NSParameters
Struktur yang berisi parameter IPv6 Neighbor Solicitation (NS). Struktur ini berisi anggota berikut:
ProtocolOffloadParameters.IPv6NSParameters.Flags
Nilai ULONG yang berisi bitwise OR dari bendera. Anggota ini dicadangkan untuk NDIS.
ProtocolOffloadParameters.IPv6NSParameters.RemoteIPv6Address[16]
Array UCHAR yang berisi alamat IPv6 opsional. Alamat ini mewakili bidang Alamat Sumber di header IPv6 dari pesan NS.
Jika pesan NS masuk memiliki nilai Alamat Sumber yang cocok dengan alamat IPv6 ini, adaptor jaringan mengirim pesan iklan tetangga (NA) saat berada dalam status daya rendah. Jika anggota ini nol, adaptor jaringan harus merespons pesan NS dari alamat IPv6 jarak jauh mana pun.
Untuk informasi selengkapnya tentang pesan IPv6 NS dan NA, lihat RFC 4861.
ProtocolOffloadParameters.IPv6NSParameters.SolicitedNodeIPv6Address[16]
Array UCHAR yang berisi alamat IPv6 simpul yang diminta. Untuk informasi selengkapnya tentang jenis alamat IPv6 ini, lihat Alamat IPv6 Multicast.
ProtocolOffloadParameters.IPv6NSParameters.MacAddress[6]
Array UCHAR yang berisi alamat MAC. Ketika mengirim pesan NA, adaptor jaringan menggunakan array ini untuk bidang alamat lapisan tautan target (TLLA) dari pesan NA.
ProtocolOffloadParameters.IPv6NSParameters.TargetIPv6Addresses[2]
Array UCHAR yang berisi satu atau dua alamat IPv6. Jika hanya berisi satu alamat, alamat tersebut disimpan dalam elemen pertama dalam array, dan elemen kedua diisi dengan nol.
Driver miniport harus menggunakan semua alamat dalam array.
Alamat ini mewakili bidang Alamat Target dari pesan NS. Jika salah satu alamat ini cocok dengan bidang Alamat Target dari pesan NS masuk, adaptor jaringan akan mengirim pesan NA sebagai respons.
ProtocolOffloadParameters.Dot11RSNRekeyParameters
Struktur yang berisi parameter jabat tangan IEEE 802.11i Robust Security Network (RSN). Struktur ini berisi anggota berikut:
ProtocolOffloadParameters.Dot11RSNRekeyParameters.Flags
Nilai ULONG yang berisi bitwise OR dari bendera. Anggota ini dicadangkan untuk NDIS.
ProtocolOffloadParameters.Dot11RSNRekeyParameters.KCK[DOT11_RSN_KCK_LENGTH]
Array UCHAR yang berisi kunci konfirmasi kunci (KCK) IEEE 802.11.
ProtocolOffloadParameters.Dot11RSNRekeyParameters.KEK[DOT11_RSN_KEK_LENGTH]
Array UCHAR yang berisi kunci enkripsi kunci (KEK) IEEE 802.11.
ProtocolOffloadParameters.Dot11RSNRekeyParameters.KeyReplayCounter
Nilai ULONGLONG yang berisi penghitung pemutaran ulang.
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2
Struktur yang berisi parameter jabat tangan V2 IEEE 802.11i Robust Security Network (RSN). Tersedia di NDIS 6.84 dan yang lebih baru. Struktur ini berisi anggota berikut:
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2.Flags
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2.KeyReplayCounter
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2.AuthAlgo
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2.KCKLength
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2.KEKLength
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2.KCK[DOT11_RSN_MAX_CIPHER_KEY_LENGTH]
ProtocolOffloadParameters.Dot11RSNRekeyParametersV2.KEK[DOT11_RSN_MAX_CIPHER_KEY_LENGTH]
_PROTOCOL_OFFLOAD_PARAMETERS
Keterangan
Struktur NDIS_PM_PROTOCOL_OFFLOAD digunakan dalam OID_PM_ADD_PROTOCOL_OFFLOAD dan OID_PM_PROTOCOL_OFFLOAD_LIST OID.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Didukung di NDIS 6.20 dan yang lebih baru. |
| Header | ntddndis.h (termasuk Ntddndis.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk