OID_PNP_ENABLE_WAKE_UP
Som en uppsättning anger OID_PNP_ENABLE_WAKE_UP OID de aktiveringsfunktioner som en miniportdrivrutin ska aktivera i ett nätverkskort.
Som en fråga hämtar OID_PNP_ENABLE_WAKE_UP de aktuella aktiveringsfunktionerna som är aktiverade för ett nätverkskort.
InformationBuffer medlem i NDIS_OID_REQUEST struktur är en bitmask med flaggor som kan användas för att aktivera en kombination av aktiveringshändelser:
NDIS_PNP_WAKE_UP_MAGIC_PACKET
När den är inställd anger att miniportdrivrutinen ska aktivera ett nätverkskort för att signalera en aktiveringshändelse när ett magiskt paket tas emot. (Ett magiskt paket är ett paket som innehåller 16 sammanhängande kopior av det mottagande nätverkskortets Ethernet-adress.) När den rensas anger att miniportdrivrutinen ska inaktivera nätverkskortet från att signalera en sådan aktiveringshändelse.
NDIS_PNP_WAKE_UP_PATTERN_MATCH
När detta anges anger att miniportdrivrutinen ska aktivera ett nätverkskort för att signalera en aktiveringshändelse vid mottagandet av ett paket som innehåller ett mönster som anges av protokollet med OID_PNP_ADD_WAKE_UP_PATTERN. När den rensas anger att miniportdrivrutinen ska inaktivera nätverkskortet från att signalera en sådan aktiveringshändelse.
NDIS_PNP_WAKE_UP_LINK_CHANGE
Reserverad. NDIS ignorerar den här flaggan.
En protokolldrivrutin använder nätverkskortets aktiveringsfunktioner i NDIS_BIND_PARAMETERS för att aktivera det associerade nätverkskortets aktiveringsfunktioner. En protokolldrivrutin kan också fråga den här OID:n för att avgöra vilka aktiveringsfunktioner som är aktiverade för ett nätverkskort.
NDIS aktiverar inte omedelbart de aktiveringsfunktioner som en protokolldrivrutin anger. I stället håller NDIS reda på de aktiveringsfunktioner som protokolldrivrutinen har aktiverat och precis innan nätverkskortet övergår till ett lågeffektstillstånd skickar NDIS en OID_PNP_ENABLE_WAKE_UP ställa in begäran till miniportdrivrutinen för att aktivera lämpliga aktiveringshändelser.
Innan nätverkskortet övergår till ett lågeffekttillstånd (det vill säga innan NDIS skickar miniportdrivrutinen en OID_PNP_SET_POWER begäran) skickar NDIS miniportdrivrutinen en OID_PNP_ENABLE_WAKE_UP begäran för att aktivera lämpliga aktiveringsfunktioner.
Miniportdrivrutinen måste vidta lämpliga enhetsberoende steg för att aktivera eller inaktivera aktiveringshändelser på nätverkskortet.
Miniportdrivrutinen bör rensa de aktiveringsfunktioner som NDIS har angett med OID_PNP_ENABLE_WAKE_UP när systemet återupptas. Väckningsfunktionerna bör inte bevaras mellan meritförteckningar. Om aktiveringsfunktioner är aktiverade anger NDIS uttryckligen OID_PNP_ENABLE_WAKE_UP innan miniporten övergår till lågeffekttillståndet.
En mellanliggande drivrutin där den övre kanten tar emot den här OID-begäran måste alltid sprida begäran till den underliggande miniportdrivrutinen genom att anropa funktionen NdisOidRequest eller NdisCoOidRequest.
Krav
Version |
Stöds i NDIS 6.0 och 6.1. För NDIS 6.20 och senare använder du OID_PM_PARAMETERS i stället). |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |