OID_WW_TAC_SHUTDOWN_DEVICE
As a query, the OID_WW_TAC_SHUTDOWN_DEVICE OID requests the miniport driver to return the current state of the NIC.
As a set, this OID requests the miniport driver to set the state of the NIC to the specified mode of operation.
This request uses a WW_TAC_SHUTDOWN_DEVICE data type, defined as equivalent to an INT.
For either a query or a set, this request uses one of the following values:
| Value | Meaning |
|---|---|
0 |
Enabled device. The miniport driver acquires required hardware resources, powers on the NIC, and resumes operation. |
1 |
Disable device. The miniport driver suspends operation, powers off NIC, and releases all hardware resources. |
-1 |
State of device unknown |
Typically, this OID can be used to disable the NIC and associated hardware to conserve battery power. During sets, a value of unknown, that is -1, is invalid; the miniport driver should return an error of NDIS_STATUS_INVALID_DATA.
If any bound protocol has enabled indications with OID_WW_GEN_INDICATION_REQUEST, the miniport driver must call NdisMIndicateStatusto notify such protocol(s) if the state of the NIC changes. It can ignore the TriggerValue member that was specified in the OID_WW_GEN_INDICATION_REQUEST.
Note This OID is not available for use beginning with Windows Vista.