OID_QOS_OPERATIONAL_PARAMETERS
上部のドライバーは、OID_QOS_OPERATIONAL_PARAMETERS のオブジェクト識別子 (OID) クエリ要求を発行して、ネットワーク アダプターの現在の NDIS サービス品質 (QoS) 操作パラメーターを取得します。 ミニポート ドライバーは、QoS パケット転送を実行するために、操作 NDIS QoS パラメーターを使用してネットワーク アダプターを構成します。
OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_QOS_PARAMETERS 構造へのポインターが含まれています。
注 この OID クエリ要求は、IEEE 802.1 データ センター ブリッジング (DCB) インターフェイスをサポートするミニポート ドライバー用に NDIS によって処理されます。
解説
NDIS は、OID_QOS_OPERATIONAL_PARAMETERS の OID クエリ要求を正常に処理すると、ミニポート ドライバーによって発行された以前の NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE 状態表示からキャッシュされた操作 NDIS QoS パラメーターを返します。 ドライバーは、この状態の表示を発行して、操作 NDIS QoS パラメーターの初期セットを報告します。 また、ドライバーは、操作 NDIS QoS パラメーターが変更されるたびに、この状態表示を発行します。
NDIS は、次のように初期化された NDIS_QOS_PARAMETERS 構造体を返します。
ミニポート ドライバーが以前に NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE 状態表示を発行していた場合は、NDIS は NDIS_QOS_PARAMETERS データをキャッシュし、OID_QOS_OPERATIONAL_PARAMETERS の OID クエリ要求に対してこのデータを返します。
ミニポート ドライバーが NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE 状態表示を発行していなかった場合は、NDIS は、すべてのメンバー (Header メンバーを除く) が 0 に設定された NDIS_QOS_PARAMETERS 構造体を返します。
操作 NDIS QoS パラメーターの詳細については、「NDIS QoS パラメーターの概要」を参照してください。
状態コードを返す
NDIS は次のステータスコードのいずれかを返します。
状態コード | 説明 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
NDIS_STATUS_NOT_SUPPORTED |
ミニポート ドライバーは、NDIS QoS インターフェイスをサポートしていません。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーの長さが sizeof(NDIS_QOS_PARAMETERS) 未満です。 NDIS sets the NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE