OID_QOS_CURRENT_CAPABILITIES

上部のドライバーは、OID_QOS_CURRENT_CAPABILITIES のオブジェクト識別子 (OID) クエリ要求を発行して、ネットワーク アダプターの現在有効な NDIS サービス品質 (QoS) ハードウェア機能を取得します。

OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造の InformationBuffer メンバーには、NDIS_QOS_CAPABILITIES 構造へのポインターが含まれています。

この OID クエリ要求は、IEEE 802.1 データ センター ブリッジング (DCB) インターフェイスをサポートするミニポート ドライバー用に NDIS によって処理されます。

解説

ミニポート ドライバーは、MiniportInitializeEx 関数が呼び出されたとき、ネットワーク アダプターの現在有効な NDIS QoS ハードウェア機能を登録します。 ドライバーは、次の手順に従ってこれらの機能を登録します。

  1. ドライバーは、有効な QoS ハードウェア機能を使用して、NDIS_QOS_CAPABILITIES 構造体を初期化します。

  2. ドライバーは、NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 構造体の CurrentQosCapabilities メンバーを NDIS_QOS_CAPABILITIES 構造体へのポインターに設定します。

  3. 次に、ミニポート ドライバーは NdisMSetMiniportAttributes 関数を呼び出し、MiniportAttributes パラメーターを NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 構造体へのポインターに設定します。

NDIS は、バインドまたはアタッチ操作中に、ネットワーク アダプターの現在有効な NDIS QoS ハードウェア機能を上部のプロトコルおよびフィルター ドライバーに報告しません。

NDIS QoS 機能を登録する方法の詳細については、「NDIS QoS 機能の登録」を参照してください。

状態コードを返す

NDIS は、ミニポート ドライバーの OID_QOS_CURRENT_CAPABILITIES 要求の OID クエリ要求を処理し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

OID 要求は正常に完了しました。

NDIS_STATUS_NOT_SUPPORTED

ミニポート ドライバーは、NDIS QoS インターフェイスをサポートしていません。

NDIS_STATUS_INVALID_LENGTH

情報バッファーの長さが sizeof(NDIS_QOS_CAPABILITIES) 未満です。 NDIS sets the NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。

NDIS_STATUS_FAILURE

その他の理由で要求に失敗しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

Ntddndis.h (Ndis.h を含む)

関連項目


MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NdisMSetMiniportAttributes

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES