OID_QOS_REMOTE_PARAMETERS
上部のドライバーは、OID_QOS_REMOTE_PARAMETERS のオブジェクト識別子 (OID) クエリ要求を発行して、リモート ピアの NDIS サービス品質 (QoS) パラメーターを取得します。 ミニポート ドライバーは、これらのリモート QoS パラメーターを使用して、操作 NDIS QoS パラメーターを解決します。 ドライバーは、QoS パケット転送を実行するために、操作パラメーターを使用してネットワーク アダプターを構成します。
OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_QOS_PARAMETERS 構造へのポインターが含まれています。
注 この OID クエリ要求は、IEEE 802.1 データ センター ブリッジング (DCB) インターフェイスをサポートするミニポート ドライバーでのみ有効です。
解説
NDIS は、OID_QOS_REMOTE_PARAMETERS の OID クエリ要求を正常に処理すると、ミニポート ドライバーによって発行された以前の NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE 状態表示からキャッシュされたリモート NDIS QoS パラメーターを返します。 ドライバーは、この状態の表示を発行して、リモート操作 NDIS QoS パラメーターの初期セットを報告します。 また、ドライバーは、リモート NDIS QoS パラメーターが変更されるたびに、この状態表示を発行します。
NDIS は、次のように初期化された NDIS_QOS_PARAMETERS 構造体を返します。
ミニポート ドライバーが以前に NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE 状態表示を発行していた場合は、NDIS は NDIS_QOS_PARAMETERS データをキャッシュし、OID_QOS_REMOTE_PARAMETERS の OID クエリ要求に対してこのデータを返します。
ミニポート ドライバーが NDIS_STATUS_QOS_REMOTE_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