OID_PM_CURRENT_CAPABILITIES

Als query kunnen overliggende stuurprogramma's de OID_PM_CURRENT_CAPABILITIES OID gebruiken om een query uit te voeren op de momenteel beschikbare mogelijkheden voor energiebeheer van een netwerkadapter. Nadat de OID-queryaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een NDIS_PM_CAPABILITIES-structuur.

Opmerkingen

NDIS verwerkt de query voor minipoortstuurprogramma's. Vanaf NDIS 6.20 leveren minipoortstuurprogramma's de hardwaremogelijkheden voor energiebeheer tijdens de initialisatie. NDIS kan echter bepaalde mogelijkheden van het protocolstuurprogramma verbergen. NDIS kan bijvoorbeeld verschillende mogelijkheden rapporteren wanneer een gebruiker bepaalde of alle mogelijkheden voor energiebeheer uitschakelt.

Houd er rekening mee dat de huidige mogelijkheden voor energiebeheer die NDIS rapporteert aan een protocolstuurprogramma niet noodzakelijkerwijs hetzelfde zijn als de hardwaremogelijkheden die het minipoortstuurprogramma heeft gerapporteerd aan NDIS.

NDIS rapporteert de energiebeheermogelijkheden van een onderliggende netwerkadapter aan overliggende protocolstuurprogramma's in de PowerManagementCapabilitiesEx lid van de NDIS_BIND_PARAMETERS-structuur tijdens de bindingsbewerking. Daarom hoeven protocolstuurprogramma's geen query's uit te voeren op de OID.

NDIS geeft een NDIS_STATUS_PM_CAPABILITIES_CHANGE statusindicatie uit om wijzigingen in de energiebeheermogelijkheden te rapporteren die beschikbaar zijn voor overliggende stuurprogramma's.

Als de onderliggende netwerkadapter een NDIS 6.1 of ouder minipoortstuurprogramma heeft, vertaalt NDIS de energiebeheermogelijkheden van de onderliggende netwerkadapter naar een NDIS_PM_CAPABILITIES structuur.

NDIS retourneert een van de volgende statuscodes voor de aanvraag:

NDIS_STATUS_SUCCESS
De aanvraag is voltooid. De InformationBuffer- verwijst naar een NDIS_PM_CAPABILITIES structuur.

NDIS_STATUS_PENDING
De aanvraag is in behandeling. NDIS geeft de laatste statuscode en resultaten door aan de voltooiingshandler van de OID-aanvraag van de aanroeper nadat de aanvraag is voltooid.

NDIS_STATUS_BUFFER_TOO_SHORT
De informatiebuffer was te kort. NDIS stelt de DATA in. QUERY_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist.

NDIS_STATUS_FAILURE
De aanvraag is om andere redenen dan de voorgaande redenen mislukt.

Eisen

Zie ook

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE