OID_QOS_PARAMETERS
データ センター ブリッジング (DCB) コンポーネント (Msdcb.sys) は、ネットワーク アダプターでローカル NDIS サービス品質 (QoS) パラメーターを構成するOID_QOS_PARAMETERSのオブジェクト識別子 (OID) メソッド要求を発行します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_QOS_PARAMETERS 構造体へのポインターが含まれています。
注 この OID メソッド要求は、IEEE 802.1 データ センター ブリッジング (DCB) インターフェイスの NDIS QoS をサポートするミニポート ドライバーには必須です。
備考
ミニポート ドライバーは、OID_QOS_PARAMETERSの OID メソッド要求を通じて、ローカル NDIS QoS パラメーターを取得します。 これらのパラメーターは、ネットワーク アダプターが送信または送信 パケット優先する方法を定義します。 これらのパラメーターの詳細については、「NDIS QoS パラメーターの概要を参照してください。
注 OID_QOS_PARAMETERSの OID メソッド要求を発行できるのは DCB コンポーネントだけです。 上にあるプロトコルまたはフィルター ドライバーは、この OID を発行しないでください。 DCB コンポーネントの詳細については、「データ センター ブリッジング の NDIS QoS アーキテクチャを参照してください。
DCB コンポーネントは、次の条件下でOID_QOS_PARAMETERS要求を発行します。
システム管理者は、Microsoft DCB サーバー機能をインストールまたはアンインストールします。
DCB サーバー機能の詳細については、「System-Provided DCB コンポーネントの」を参照してください。
システム管理者は、機能のインストール中に DCB サーバー機能を有効または無効にします。
システム管理者は、DCB サーバー機能パラメーターのいずれかを変更します。
DCB サーバー機能のインストール中にオペレーティング システムが起動または再起動します。
ミニポート ドライバーがOID_QOS_PARAMETERSの OID メソッド要求を処理する場合は、次のガイドラインに従う必要があります。
ミニポート ドライバーは、ローカル NDIS QoS パラメーターのキャッシュに NDIS_QOS_PARAMETERS 構造体内のデータをコピーします。 その後、ドライバーは、ローカル NDIS QoS パラメーターのキャッシュと、リモート ピアから受信した NDIS QoS パラメーターのキャッシュに基づいて、その運用 NDIS QoS パラメーターを解決します。
ミニポート ドライバーが操作パラメーターを解決する方法の詳細については、「操作 NDIS QoS パラメーターの解決を参照してください。
ミニポート ドライバーは、NDIS_QOS_PARAMETERS 構造体内に含まれているデータを変更することはできません。 ドライバーは、OID メソッドの要求を完了し、NDIS_QOS_PARAMETERS 構造体内の元のデータを返す必要があります。
NDIS_QOS_PARAMETERS_WILLING フラグは、ミニポート ドライバーが有効にするか、ローカル データ センター ブリッジング Exchange (DCBX) の Willing 状態を無効にするかどうかを指定します。 ドライバーは、次の方法でこのフラグを処理します。
このフラグが設定されている場合、ミニポート ドライバーは、ローカル DCBX Willing 状態を有効にする必要があります。 これにより、ドライバーを QoS 設定でリモートで構成できます。 この場合、ドライバーは、リモート QoS パラメーターに基づいて動作 QoS パラメーターを解決します。 ミニポート ドライバーは、独立したハードウェア ベンダー (IHV) によって定義されている独自の QoS 設定に基づいて動作 QoS パラメーターを解決することもできます。
このフラグが設定されていない場合、ミニポート ドライバーは、ローカル DCBX Willing 状態を無効にする必要があります。 これにより、ドライバーは、リモート QoS パラメーターではなく、ローカル QoS パラメーターから操作 QoS パラメーターを解決できます。 ミニポート ドライバーも無効にするか、関連する NDIS_QOS_PARAMETERS_Xxx_CONFIGURED フラグが設定されていないローカル QoS パラメーターをオーバーライドする必要があります。
たとえば、ミニポート ドライバーは、IHV によって定義されている QoS パラメーターの独自の設定で未構成のローカル QoS パラメーターをオーバーライドできます。 NDIS_QOS_PARAMETERS_Xxx_CONFIGURED フラグで指定されていないローカル QoS パラメーターの独自の設定がない場合、ドライバーは、ネットワーク アダプターでこれらの QoS パラメーターの使用を無効にする必要があります。
注 ドライバーは、ネットワーク アダプターで有効になっているプロトコルまたはテクノロジで使用される QoS パラメーターを侵害した場合にも、構成されたローカル QoS パラメーターをオーバーライドできます。 たとえば、ネットワーク アダプターがイーサネット経由のファイバー チャネル (FCoE) プロトコルを介してリモート ブートが有効になっている場合、ドライバーはローカル QoS パラメーターをオーバーライドできます。
ローカル DCBX のウィリング状態の詳細については、「ローカル DCBX のウィリング状態の管理」を参照してください。
ミニポート ドライバーがローカル QoS パラメーターをオーバーライドする方法の詳細については、「NDIS QoS パラメーターの管理 を参照してください。
注 ローカル QoS パラメーターをオーバーライドすると、ミニポート ドライバーは、OID_QOS_PARAMETERSの OID メソッド要求を失敗させる必要があります。
ミニポート ドライバーがローカル QoS パラメーターを管理する方法の詳細については、「ローカル NDIS QoS パラメーターの設定を参照してください。
戻り値の状態コード
ミニポート ドライバーは、次のいずれかの状態コードを返します。
| 状態コード | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求が正常に完了しました。 |
NDIS_STATUS_PENDING |
OID 要求の完了が保留中です。 ミニポート ドライバーが NdisMOidRequestComplete呼び出すと、NDIS は最終的な状態コードと結果を、要求の完了後に呼び出し元の OID 要求完了ハンドラーに渡します。 |
NDIS_STATUS_NOT_SUPPORTED |
ミニポート ドライバーは、NDIS QoS インターフェイスをサポートしていません。 |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_QOS_PARAMETERS 構造体の 1 つ以上のメンバーに正しくない値が含まれています。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーの長さが、sizeof(NDIS_QOS_PARAMETERS) 未満です。 NDIS は、データを設定します。QUERY_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
NdisMOidRequestCompleteの