OID_PM_WOL_PATTERN_LIST

Som en fråga kan överliggande drivrutiner använda OID_PM_WOL_PATTERN_LIST OID för att räkna upp aktivering av LAN-mönster som anges på ett underliggande nätverkskort. Efter en lyckad retur från frågan innehåller InformationBuffer medlem i NDIS_OID_REQUEST-strukturen en pekare till en lista över NDIS_PM_WOL_PATTERN strukturer som beskriver de för närvarande tillagda WOL-mönstren.

Anmärkningar

NDIS hanterar frågan för miniportdrivrutiner. NDIS-drivrutiner kan använda OID_PM_WOL_PATTERN_LIST OID för att hämta en lista över aktivering av LAN-mönster som har angetts på ett underliggande nätverkskort.

För varje NDIS_PM_WOL_PATTERN struktur i listan anger NDIS NextWoLPatternOffset 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_WOL_PATTERN struktur i listan. Förskjutningen i NextWoLPatternOffset medlem i den sista strukturen i listan är noll.

För förskjutningar i en annan NDIS_PM_WOL_PATTERN struktur än NextWoLPatternOffset (till exempel NameBufferOffset) tillhandahåller NDIS förskjutningar som är relativa till början av varje NDIS_PM_WOL_PATTERN struktur.

Om det inte finns några WOL-mönster 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 för begäran. 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 WOL-mönster.

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)

Se även

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

OID_PM_ADD_WOL_PATTERN

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_WAKE_UP_PATTERN_LIST