struttura NET_PNP_EVENT_NOTIFICATION (ndis.h)

Articolo
02/26/2024

La struttura NET_PNP_EVENT_NOTIFICATION descrive un evento di rete Plug and Play (PnP), un evento NDIS PnP o un evento di risparmio energia.

Sintassi

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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NET_PNP_EVENT_NOTIFICATION. NDIS imposta il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NET_PNP_EVENT_NOTIFICATION_REVISION_1 e il membro Size su NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1.

PortNumber

Porta di origine della notifica degli eventi. Se l'indicazione dello stato non è specifica per una porta, PortNumber è zero.

NetPnPEvent

Struttura NET_PNP_EVENT che descrive l'evento.

Flags

Flag per questa notifica degli eventi.

Importante

Per i driver miniport che chiamano NdisMNetPnPEvent, se VPortId è impostato su un valore diverso da NDIS_DEFAULT_VPORT_ID, i flag devono essere impostati su NET_EVENT_FLAGS_VPORT_ID_VALID per rendere effettivo VPortId .

Altri valori per Flag sono riservati per NDIS.

SwitchId

Valore NDIS_NIC_SWITCH_ID che specifica un identificatore di opzione. L'identificatore del commutatore è un numero intero compreso tra zero e il numero di commutatori supportati dalla scheda di rete. Un valore NDIS_DEFAULT_SWITCH_ID indica il commutatore della scheda di rete predefinito.

VPortId

Valore NDIS_NIC_SWITCH_VPORT_ID che identifica in modo univoco la porta virtuale (VPort) nella scheda di rete.

Il valore di NDIS_DEFAULT_VPORT_ID specifica il VPort predefinito sull'opzione. Il VPort predefinito è sempre collegato alla funzione fisica PCI Express (PCIe) della scheda di rete.

Nota

Un VPort non predefinito con il valore VPortId specificato deve essere stato creato in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.

Commenti

Quando il sistema operativo rilascia un evento PnP di sistema o un evento di risparmio energia a un oggetto dispositivo di destinazione che rappresenta un adattatore, NDIS converte l'evento in una struttura NET_PNP_EVENT_NOTIFICATION.

Il membro NetPnPEvent è una struttura NET_PNP_EVENT . Il membro NetEvent di questa struttura NET_PNP_EVENT specifica un codice evento che identifica l'evento PnP di rete, l'evento NDIS PnP o l'evento di risparmio energia.

Il membro Buffer , che si trova nella struttura NET_PNP_EVENT specificata nel membro NetPnPEvent di NET_PNP_EVENT_NOTIFICATION, specifica l'indirizzo di un buffer contenente informazioni specifiche dell'evento indicato dal membro NetEvent .

NDIS genera anche notifiche degli eventi PnP per eventi NDIS PnP, ad esempio NetEventPause, NetEventRestart, NetEventPortActivation e NetEventPortDeactivation.

NDIS passa un puntatore a una struttura NET_PNP_EVENT_NOTIFICATION alla funzione FilterNetPnPEvent di driver di filtro eccessivo e alla funzione ProtocolNetPnPEvent di driver di protocollo overlying.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Intestazione	ndis.h (include Ndis.h)

Vedi anche