OID_PM_PARAMETERS
Som en fråga kan protokolldrivrutiner använda OID_PM_PARAMETERS OID för att köra frågor mot maskinvarufunktionerna för energisparfunktioner i ett nätverkskort som för närvarande är aktiverat. Efter en lyckad retur från OID-frågebegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en NDIS_PM_PARAMETERS struktur.
Som en uppsättning kan protokolldrivrutiner använda OID_PM_PARAMETERS OID för att aktivera eller inaktivera de aktuella maskinvarufunktionerna för ett nätverkskort. Protokolldrivrutinen ger en pekare till en NDIS_PM_PARAMETERS struktur i InformationBuffer medlem i den NDIS_OID_REQUEST strukturen.
Anmärkningar
Från och med NDIS 6.20 använder alltför många protokoll- och filterdrivrutiner OID_PM_PARAMETERS för att fråga efter och ange maskinvarufunktionerna för energisparfunktioner för ett nätverkskort som för närvarande är aktiverat.
När en övergående drivrutin frågar OID_PM_PARAMETERS OID slutför NDIS begäran utan att vidarebefordra den till miniportdrivrutinen. NDIS lagrar de begärda inställningarna och kombinerar dem med inställningarna från andra sådana begäranden. Innan NDIS övergår nätverkskortet till låg effekt skickar NDIS en uppsättning begäran till miniportdrivrutinen som innehåller de kombinerade inställningarna från alla begäranden som NDIS lagrade.
De funktioner som för närvarande är aktiverade kan vara en delmängd av de funktioner som maskinvaran stöder. Mer information om de funktioner som maskinvaran stöder finns i OID_PM_HARDWARE_CAPABILITIES.
Obs Om NDIS anger flaggan NDIS_PM_SELECTIVE_SUSPEND_ENABLED i WakeUpFlags medlem i NDIS_PM_PARAMETERS struktur, utfärdar den OID-uppsättningens begäran om OID_PM_PARAMETERS direkt till miniportdrivrutinen. Detta gör att NDIS kan kringgå bearbetningen av filterdrivrutiner i nätverksdrivrutinsstacken.
NDIS eller miniportdrivrutinen returnerar någon av följande statuskoder för begäran:
NDIS_STATUS_SUCCESS
Begäran har slutförts.
NDIS_STATUS_PENDING
Begäran väntar på att slutföras. NDIS skickar den slutliga statuskoden och resultaten till OID-begärans slutförandehanterare för anroparen när begäran har slutförts.
NDIS_STATUS_BUFFER_TOO_SHORT
Informationsbufferten var för kort. NDIS anger DATA. QUERY_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs.
NDIS_STATUS_INVALID_PARAMETER
Begäran misslyckades eftersom den försökte aktivera en funktion som det underliggande nätverkskortet inte stöder.
NDIS_STATUS_FAILURE
Begäran misslyckades av andra orsaker än de föregående orsakerna.
Krav
Version |
Stöds i NDIS 6.20 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |