struktur NET_PNP_EVENT_NOTIFICATION (ndis.h)

Artikel
02/29/2024

Struktur NET_PNP_EVENT_NOTIFICATION menjelaskan peristiwa Plug and Play jaringan (PnP), peristiwa PnP NDIS, atau peristiwa manajemen daya.

Sintaks

typedef struct _NET_PNP_EVENT_NOTIFICATION {
  NDIS_OBJECT_HEADER       Header;
  NDIS_PORT_NUMBER         PortNumber;
  NET_PNP_EVENT            NetPnPEvent;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_ID       SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NET_PNP_EVENT_NOTIFICATION, *PNET_PNP_EVENT_NOTIFICATION;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NET_PNP_EVENT_NOTIFICATION. NDIS mengatur anggota Jenis struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_DEFAULT, anggota Revisi ke NET_PNP_EVENT_NOTIFICATION_REVISION_1, dan anggota Ukuran ke NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.

PortNumber

Port sumber pemberitahuan peristiwa. Jika indikasi status tidak spesifik untuk port, PortNumber adalah nol.

NetPnPEvent

Struktur NET_PNP_EVENT yang menjelaskan peristiwa.

Flags

Bendera untuk pemberitahuan kejadian ini.

Penting

Untuk driver miniport yang memanggil NdisMNetPnPEvent, jika VPortId diatur ke nilai yang berbeda dari NDIS_DEFAULT_VPORT_ID maka Bendera harus diatur ke NET_EVENT_FLAGS_VPORT_ID_VALID agar VPortId berlaku.

Nilai lain untuk Bendera disediakan untuk NDIS.

SwitchId

Nilai NDIS_NIC_SWITCH_ID yang menentukan pengidentifikasi sakelar. Pengidentifikasi sakelar adalah bilangan bulat antara nol dan jumlah sakelar yang didukung adaptor jaringan. Nilai NDIS_DEFAULT_SWITCH_ID menunjukkan sakelar adaptor jaringan default.

VPortId

Nilai NDIS_NIC_SWITCH_VPORT_ID yang secara unik mengidentifikasi port virtual (VPort) pada adaptor jaringan.

Nilai NDIS_DEFAULT_VPORT_ID menentukan VPort default pada sakelar. VPort default selalu dilampirkan ke Fungsi Fisik (PF) PCI Express (PCIe) dari adaptor jaringan.

Catatan

VPort nondefault dengan nilai VPortId yang ditentukan sebelumnya harus dibuat melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.

Keterangan

Ketika sistem operasi mengeluarkan peristiwa PnP sistem atau peristiwa manajemen daya ke objek perangkat target yang mewakili adaptor, NDIS menerjemahkan peristiwa ke dalam struktur NET_PNP_EVENT_NOTIFICATION.

Anggota NetPnPEvent adalah struktur NET_PNP_EVENT . Anggota NetEvent dari struktur NET_PNP_EVENT ini menentukan kode peristiwa yang mengidentifikasi peristiwa PnP jaringan, peristiwa PnP NDIS, atau peristiwa manajemen daya.

Anggota Buffer , yang berada dalam struktur NET_PNP_EVENT yang ditentukan dalam anggota NetPnPEvent dari NET_PNP_EVENT_NOTIFICATION, menentukan alamat buffer yang berisi informasi yang khusus untuk peristiwa yang ditunjukkan oleh anggota NetEvent .

NDIS juga mengeluarkan pemberitahuan peristiwa PnP untuk peristiwa PnP NDIS seperti NetEventPause, NetEventRestart, NetEventPortActivation, dan NetEventPortDeactivation.

NDIS meneruskan pointer ke struktur NET_PNP_EVENT_NOTIFICATION ke fungsi FilterNetPnPEvent dari driver filter yang terlalu penting dan ke fungsi ProtocolNetPnPEvent dari driver protokol yang terlalu berlebihan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Header	ndis.h (termasuk Ndis.h)

Lihat juga