OID_PM_PROTOCOL_OFFLOAD_LIST
Som en fråga kan överliggande drivrutiner använda OID_PM_PROTOCOL_OFFLOAD_LIST OID för att räkna upp protokoll avlastningar som anges på ett underliggande nätverkskort. Efter en lyckad retur från OID-frågebegäran innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en lista över NDIS_PM_PROTOCOL_OFFLOAD strukturer som beskriver de för närvarande aktiva protokoll-avlastningarna.
Anmärkningar
NDIS hanterar frågan för miniportdrivrutiner. NDIS-drivrutiner kan använda OID_PM_PROTOCOL_OFFLOAD_LIST OID för att hämta en lista över protokoll avlastningar som har angetts på ett underliggande nätverkskort.
För varje NDIS_PM_PROTOCOL_OFFLOAD struktur i listan anger NDIS NextProtocolOffloadOffset medlem till förskjutningen från början av OID-informationsbufferten (dvs. början av bufferten som InformationBuffer medlem i NDIS_OID_REQUEST struktur pekar på) till början av nästa NDIS_PM_PROTOCOL_OFFLOAD struktur i listan. Förskjutningen i NextProtocolOffloadOffset medlem i den sista strukturen i listan är noll.
Om det inte finns några protokoll avlastningar som har angetts på nätverkskortet anger NDIS DATA. QUERY_INFORMATION. BytesWritten medlem i NDIS_OID_REQUEST struktur till noll och returnerar NDIS_STATUS_SUCCESS. Data i DATA. QUERY_INFORMATION. InformationBuffer medlem ändras inte av NDIS.
NDIS returnerar någon av följande statuskoder för begäran:
NDIS_STATUS_SUCCESS
Begäran har slutförts.
InformationBuffer- innehåller en pekare till en lista över eventuella protokollaviseringar.
NDIS_STATUS_PENDING
Begäran väntar på att slutföras. Den slutliga statuskoden och resultaten skickas till OID-begärandehanteringshanteraren för anroparen.
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_FAILURE
Begäran misslyckades av andra orsaker än de föregående orsakerna.
Krav
Version |
Stöds i NDIS 6.20 och senare. Begärs inte för miniportdrivrutiner. (Se avsnittet Kommentarer.) |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |