OID_PM_REMOVE_PROTOCOL_OFFLOAD

As a set request, NDIS and protocol drivers use the OID_PM_REMOVE_PROTOCOL_OFFLOAD OID to remove a power management protocol offload from a network adapter. The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to a ULONG protocol offload identifier.

Remarks

NDIS and protocol drivers use the OID_PM_REMOVE_PROTOCOL_OFFLOAD OID to remove a protocol offload from the underlying network adapter.

The DATA.SET_INFORMATION.InformationBuffer member of the NDIS_OID_REQUEST structure must point to a ULONG value for a previously added protocol offload identifier. NDIS sets this protocol offload identifier in the ProtocolOffloadId member of the NDIS_PM_PROTOCOL_OFFLOAD structure when NDIS sent the prior OID_PM_ADD_PROTOCOL_OFFLOAD OID request to the underlying network adapter.

Remarks for miniport driver writers

NDIS ensures that the buffer size is at least sizeof(ULONG) and contains a valid protocol offload ID. Therefore, a miniport driver's MiniportOidRequest function should return NDIS_STATUS_SUCCESS for this request.

Note  If the miniport driver is resetting, its MiniportOidRequest function should return NDIS_STATUS_NOT_ACCEPTED.

Return status codes

NDIS returns one of the following status codes for this request:

NDIS_STATUS_SUCCESS
The protocol offload was removed successfully.

NDIS_STATUS_PENDING
The request is pending completion. NDIS will pass the final status code and results to the OID request completion handler of the caller after the request is complete.

NDIS_STATUS_INVALID_LENGTH
The information buffer is too small. NDIS sets the DATA.SET_INFORMATION.BytesNeeded member in the NDIS_OID_REQUEST structure to the minimum buffer size that is required, in bytes.

NDIS_STATUS_FILE_NOT_FOUND
The protocol offload identifier in the OID request is not valid.

Requirements

Version

Supported in NDIS 6.20 and later. Mandatory for miniport drivers.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_OID_REQUEST

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD