OID_QOS_OPERATIONAL_PARAMETERS

An overlying driver issues an object identifier (OID) query request of OID_QOS_OPERATIONAL_PARAMETERS to obtain the current NDIS Quality of Service (QoS) operational parameters for a network adapter. The miniport driver configures the network adapter with the operational NDIS QoS parameters in order to perform QoS packet transmission.

After a successful return from the OID query request, the InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to an NDIS_QOS_PARAMETERS structure.

Note  This OID query request is handled by NDIS for miniport drivers that support the IEEE 802.1 Data Center Bridging (DCB) interface.

Remarks

When NDIS handles the OID query request of OID_QOS_OPERATIONAL_PARAMETERS successfully, it returns the operational NDIS QoS parameters that it had cached from the previous NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE status indication that was issued by the miniport driver. The driver issues this status indication to report on the initial set of operational NDIS QoS parameters. The driver also issues this status indication whenever the operational NDIS QoS parameters change.

NDIS returns an NDIS_QOS_PARAMETERS structure that is initialized in the following way:

For more information on operational NDIS QoS parameters, see Overview of NDIS QoS Parameters.

Return Status Codes

NDIS returns one of the following status codes.

Status Code Description

NDIS_STATUS_SUCCESS

The OID request completed successfully.

NDIS_STATUS_NOT_SUPPORTED

The miniport driver does not support the NDIS QoS interface.

NDIS_STATUS_INVALID_LENGTH

The length of the information buffer is less than sizeof(NDIS_QOS_PARAMETERS). NDIS sets the DATA.QUERY_INFORMATION.BytesNeeded member in the NDIS_OID_REQUEST structure to the minimum buffer size that is required.

NDIS_STATUS_FAILURE

The request failed for other reasons.

Requirements

Version

Supported in NDIS 6.30 and later.

Header

Ntddndis.h (include Ndis.h)

See also


NdisMOidRequestComplete

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE

OID_QOS_PARAMETERS