Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De OID_PNP_CAPABILITIES OID vraagt een minipoortstuurprogramma om de ontwaakmogelijkheden van de netwerkadapter te retourneren of vraagt een tussenliggend stuurprogramma om de ontwaakmogelijkheden van het tussenliggende stuurprogramma te retourneren. De ontwaakmogelijkheden zijn opgemaakt als een NDIS_PNP_CAPABILITIES structuur, die als volgt wordt gedefinieerd:
typedef struct _NDIS_PNP_CAPABILITIES {
ULONG Flags;
NDIS_PM_WAKE_UP_CAPABILITIES WakeUpCapabilities;
} NDIS_PNP_CAPABILITIES, *PNDIS_PNP_CAPABILITIES;
De leden van deze structuur bevatten de volgende informatie:
vlaggen
NDIS_DEVICE_WAKE_UP_ENABLE
NDIS stelt deze vlag in als het onderliggende minipoortstuurprogramma een of meer ontwaakmogelijkheden ondersteunt. Protocolstuurprogramma's kunnen deze vlag testen om te bepalen of een onderliggend minipoortstuurprogramma ontwaakmogelijkheden heeft. Miniportstuurprogramma's mogen geen toegang krijgen tot deze vlag.
WakeUpCapabilities
Een NDIS_PM_WAKE_UP_CAPABILITIES structuur die de ontwaakmogelijkheden van de netwerkadapter van het minipoortstuurprogramma aangeeft. De NDIS_PM_WAKE_UP_CAPABILITIES structuur wordt als volgt gedefinieerd:
typedef struct _NDIS_PM_WAKE_UP_CAPABILITIES {
NDIS_DEVICE_POWER_STATE MinMagicPacketWakeUp;
NDIS_DEVICE_POWER_STATE MinPatternWakeUp;
NDIS_DEVICE_POWER_STATE MinLinkChangeWakeUp;
} NDIS_PM_WAKE_UP_CAPABILITIES, *PNDIS_PM_WAKE_UP_CAPABILITIES;
De leden van deze structuur bevatten de volgende informatie:
MinMagicPacketWakeUp-
Hiermee geeft u de laagste energiestatus van het apparaat op waaruit de netwerkadapter van het minipoortstuurprogramma een ontwaak kan signaleert bij ontvangst van een magic-pakket. (Een magic-pakket is een pakket dat 16 aaneengesloten kopieën van het Ethernet-adres van de ontvangende netwerkadapter bevat.) De energiestatus van het apparaat wordt opgegeven als een van de volgende NDIS_DEVICE_POWER_STATE waarden:
NdisDeviceStateUnspecified
De netwerkadapter biedt geen ondersteuning voor magic-packet wake-ups.
NdisDeviceStateD0
De netwerkadapter kan duiden op een magic-packet wake-up van apparaat energiestatus D0. Omdat D0 de volledig aangedreven status is, veroorzaakt dit geen ontwaakbewerking, maar kan deze worden gebruikt als een runtimegebeurtenis.
NdisDeviceStateD1
De netwerkadapter kan duiden op een magic-packet wake-up van apparaat energiestatusSen D1 en D0.
NdisDeviceStateD2-
De netwerkadapter kan duiden op een magic-packet wake-up van apparaatstatusSen D2, D1 en D0.
NdisDeviceStateD3-
De netwerkadapter kan duiden op een magic-pakket ontwaakt van apparaatstroomstatusSen D3, D2, D1 en D0.
MinPatternWakeUp-
Hiermee geeft u de laagste energiestatus van het apparaat waaruit de netwerkadapter van het minipoortstuurprogramma een ontwaakgebeurtenis kan signaleren bij ontvangst van een netwerkframe dat een patroon bevat dat is opgegeven door het protocolstuurprogramma. De energiestatus wordt opgegeven als een van de volgende NDIS_DEVICE_POWER_STATE waarden:
NdisDeviceStateUnspecified
De netwerkadapter biedt geen ondersteuning voor wake-ups van patroonovereenkomsten.
NdisDeviceStateD0
De netwerkadapter kan duiden op een patroon-match ontwaakt van apparaatstroomstatus D0. Omdat D0 de volledig aangedreven status is, veroorzaakt dit geen ontwaakbewerking, maar kan deze worden gebruikt als een runtimegebeurtenis.
NdisDeviceStateD1
De netwerkadapter kan duiden op een patroon-match wake-up van apparaatstroomstatusSen D1 en D0.
NdisDeviceStateD2-
De netwerkadapter kan duiden op een patroon-match wake-up van apparaatstroomstatusSen D2, D1 en D0.
NdisDeviceStateD3-
De netwerkadapter kan duiden op een patroon-match wake-up van apparaatstroomstatusSen D3, D2, D1 en D0.
MinLinkChangeWakeUp-
Gereserveerd. NDIS negeert dit lid.
Voor minipoortstuurprogramma's
Nadat het minipoortstuurprogramma is geïnitialisatie voltooid, kunnen zowel het protocolstuurprogramma als NDIS een query uitvoeren op het minipoortstuurprogramma met deze OID om het volgende te bepalen:
Of het minipoortstuurprogramma PM-bewust is.
De mogelijkheden van de netwerkadapter voor het aangeven van ontwaakgebeurtenissen in het netwerk.
Als het minipoortstuurprogramma NDIS_STATUS_SUCCESS retourneert naar een query van OID_PNP_CAPABILITIES, beschouwt NDIS het minipoortstuurprogramma als PM-bewust. Als het minipoortstuurprogramma NDIS_STATUS_NOT_SUPPORTEDretourneert, beschouwt NDIS het minipoortstuurprogramma als een verouderd minipoortstuurprogramma dat niet PM-bewust is.
Wanneer u NdisMSetAttributesEx-aanroept, kan een minipoortstuurprogramma dat geen ontwaakmogelijkheden ondersteunt, maar die de status van de netwerkadapter kan opslaan en herstellen tijdens een overgang van de energiestatus, de vlag NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND instellen. Als u deze vlag instelt, voorkomt u dat NDIS de MiniportHalt--functie aanroept voordat het systeem overgaat naar een status met weinig vermogen (slaapstand). Als het minipoortstuurprogramma echter NDIS_STATUS_NOT_SUPPORTED retourneert als reactie op een query OID_PNP_CAPABILITIES, negeert NDIS de NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND vlag en stopt de netwerkadapter als het systeem een lage energiestatus heeft.
De netwerkadapter van een minipoortstuurprogramma kan elke combinatie van wake-upgebeurtenissen ondersteunen, inclusief geen ontwaakgebeurtenissen. Een minipoortstuurprogramma kan nog steeds energiebeheer ondersteunen, zelfs als de netwerkadapter geen ontwaakgebeurtenissen kan signalen. In dit geval zijn de enige energiebeheer-OID's die het minipoortstuurprogramma ondersteunt naast OID_PNP_CAPABILITIES OID_PNP_QUERY_POWER en OID_PNP_SET_POWER.
Als de netwerkadapter van een minipoortstuurprogramma geen ondersteuning biedt voor een bepaalde wake-upgebeurtenis, moet het minipoortstuurprogramma een NDIS_DEVICE_POWER_STATE waarde aangeven van NdisDeviceStateUnspecified voor de wake-upgebeurtenis in de NDIS_PM_WAKE_UP_CAPABILITIES structuur.
OID_PNP_CAPABILITIES geeft alleen de ontwaakmogelijkheden van de netwerkadapter van een minipoortstuurprogramma aan; het maakt dergelijke mogelijkheden niet mogelijk. OID_PNP_ENABLE_WAKE_UP wordt gebruikt om de ontwaakmogelijkheden van een netwerkadapter mogelijk te maken.
Voor tussenliggende stuurprogramma's
Als de onderliggende netwerkadapter PM-bewust is, moet het tussenliggende stuurprogramma NDIS_STATUS_SUCCESS retourneren aan een query van OID_PNP_CAPABILITIES. In de NDIS_PM_WAKE_UP_CAPABILITIES structuur die door deze OID wordt geretourneerd, moet het tussenliggende stuurprogramma een apparaatstroomstatus opgeven van NdisDeviceStateUnspecified voor elke ontwaakmogelijkheid (MinMagicPacketWakeUp- of MinPatternWakeUp). Een dergelijk antwoord geeft aan dat het tussenliggende stuurprogramma PM-bewust is, maar geen fysiek apparaat beheert.
Als de onderliggende netwerkadapter niet PM-bewust is, moet het tussenliggende stuurprogramma NDIS_STATUS_NOT_SUPPORTED retourneren aan een query van OID_PNP_CAPABILITIES.
Opmerking Zie Reporting Power Management Capabilitiesvoor informatie over hoe NDIS 6.20- en latere miniportstuurprogramma's energiebeheerfuncties rapporteren.
Eisen
Versie |
Ondersteund in NDIS 6.0 en NDIS 6.1. Gebruik in plaats daarvan OID_PM_CURRENT_CAPABILITIES voor NDIS 6.20 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |