struktur NDIS_PM_WAKE_PACKET (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_PM_WAKE_PACKET menjelaskan paket jaringan (dikenal sebagai paket bangun) yang menyebabkan adaptor jaringan menghasilkan peristiwa bangun.

Sintaks

typedef struct _NDIS_PM_WAKE_PACKET {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  ULONG                  PatternId;
  NDIS_PM_COUNTED_STRING PatternFriendlyName;
  ULONG                  OriginalPacketSize;
  ULONG                  SavedPacketSize;
  ULONG                  SavedPacketOffset;
} NDIS_PM_WAKE_PACKET, *PNDIS_PM_WAKE_PACKET;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_PM_WAKE_PACKET . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_PM_WAKE_PACKET , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_PM_WAKE_PACKET_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera. Anggota ini dicadangkan untuk NDIS.

PatternId

Nilai ULONG yang menentukan pengidentifikasi pola wake-on-LAN (WOL) yang cocok dengan paket bangun. Pengidentifikasi ini ditentukan oleh anggota PatternId dari struktur NDIS_PM_WOL_PATTERN yang diteruskan ke driver selama permintaan set OID OID_PM_ADD_WOL_PATTERN.

PatternFriendlyName

Nilai NDIS_PM_COUNTED_STRING yang berisi deskripsi pola bangun yang ramah yang ditentukan oleh anggota PatternId . Nilai ini ditentukan oleh anggota FriendlyName dari struktur NDIS_PM_WOL_PATTERN yang diteruskan ke driver selama permintaan OID OID_PM_ADD_WOL_PATTERN.

Catatan Driver miniport tidak perlu menginisialisasi anggota ini. NDIS mengatur anggota PatternFriendlyName ke nilai yang benar sebelum meneruskan struktur NDIS_PM_WAKE_PACKET ke driver yang terlalu mendasar.

OriginalPacketSize

Nilai ULONG yang menentukan panjang asli, dalam satuan byte, dari paket bangun.

SavedPacketSize

Nilai ULONG yang menentukan panjang, dalam satuan byte, dari data paket bangun yang mengikuti struktur ini.

Catatan Nilai anggota ini setidaknya min(wake packet size, 128) harus byte.

SavedPacketOffset

Nilai ULONG yang menentukan offset, dalam satuan byte, ke data paket bangun yang mengikuti struktur ini. Offset diukur dari awal struktur NDIS_PM_WAKE_PACKET ke awal buffer yang berisi paket bangun.

Catatan Offset ke paket bangun yang disimpan harus diselaraskan pada batas 64-bit.

Keterangan

Struktur NDIS_PM_WAKE_PACKET digunakan dalam indikasi status NDIS_STATUS_PM_WAKE_REASON . Untuk informasi selengkapnya tentang cara mengeluarkan indikasi status ini, lihat Menerbitkan Indikasi Status Alasan Bangun NDIS.