OID_QOS_REMOTE_PARAMETERS
An overlying driver issues an object identifier (OID) query request of OID_QOS_REMOTE_PARAMETERS to obtain the NDIS Quality of Service (QoS) parameters for a remote peer. The miniport driver uses these remote QoS parameters to resolve its operational NDIS QoS parameters. The driver configures the network adapter with the operational 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 valid only for miniport drivers that support the IEEE 802.1 Data Center Bridging (DCB) interface.
Remarks
When NDIS handles the OID request of OID_QOS_REMOTE_PARAMETERS successfully, it returns the remote NDIS QoS parameters that it had cached from the previous NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE status indication that was issued by the miniport driver. The driver issues this status indication to report on the initial set of remote NDIS QoS parameters. The driver also issues this status indication whenever the remote NDIS QoS parameters change.
NDIS returns an NDIS_QOS_PARAMETERS structure that is initialized in the following way:
If the miniport driver previously issued an NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE status indication, NDIS caches the NDIS_QOS_PARAMETERS data and returns this data for the OID query request of OID_QOS_REMOTE_PARAMETERS.
If the miniport driver did not issue an NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE status indication, NDIS returns an NDIS_QOS_PARAMETERS structure with all the members (with the exception of the Header member) set to zero.
For more information on remote 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
NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE