OID_QOS_PARAMETERS
資料中心橋接 (DCB) 元件 (Msdcb.sys) 發出 (OID) 方法要求OID_QOS_PARAMETERS,以在網路介面卡上設定本機 NDIS 服務品質 (QoS) 參數。
NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_QOS_PARAMETERS結構的指標。
注意 此 OID 方法要求是支援 IEEE 802.1 資料中心橋接 (DCB) 介面的 NDIS QoS 的迷你埠驅動程式的必要要求。
備註
迷你埠驅動程式會透過 OID_QOS_PARAMETERS 的 OID 方法要求,取得本機 NDIS QoS 參數。 這些參數會定義網路介面卡如何設定傳輸或 輸出封包的優先順序。 如需這些參數的詳細資訊,請參閱 NDIS QoS 參數概觀。
注意 只有 DCB 元件可以發出 OID_QOS_PARAMETERS 的 OID 方法要求。 過度配置通訊協定或篩選驅動程式不得發出此 OID。 如需 DCB 元件的詳細資訊,請參閱 資料中心橋接的 NDIS QoS 架構。
DCB 元件會在下列情況下發出OID_QOS_PARAMETERS要求:
系統管理員會安裝或卸載 Microsoft DCB 伺服器功能。
如需 DCB 伺服器功能的詳細資訊,請參閱 系統提供的 DCB 元件。
當仍安裝此功能時,系統管理員會啟用或停用 DCB 伺服器功能。
系統管理員會變更任何 DCB 伺服器功能參數。
安裝 DCB 伺服器功能時,作業系統會啟動或重新開機。
當迷你埠驅動程式處理OID_QOS_PARAMETERS的 OID 方法要求時,必須遵循下列指導方針:
迷你埠驅動程式會將 NDIS_QOS_PARAMETERS 結構中的資料複製到本機 NDIS QoS 參數的快取中。 然後,驅動程式會根據其本機 NDIS QoS 參數的快取及其從遠端對等接收的 NDIS QoS 參數快取,解析其運作 NDIS QoS 參數。
如需迷你埠驅動程式如何解析其指令引數的詳細資訊,請參閱 解析操作 NDIS QoS 參數。
迷你埠驅動程式不得修改包含在 NDIS_QOS_PARAMETERS 結構內的任何資料。 驅動程式必須完成 OID 方法要求,並傳回 NDIS_QOS_PARAMETERS 結構內的原始資料。
NDIS_QOS_PARAMETERS_WILLING旗標會指定迷你埠驅動程式是否啟用或停用本機資料中心橋接 Exchange (DCBX) 願意狀態。 驅動程式會以下列方式處理此旗標:
如果設定此旗標,迷你埠驅動程式必須啟用本機 DCBX 願意狀態。 這可讓驅動程式使用 QoS 設定從遠端設定。 在此情況下,驅動程式會根據遠端 QoS 參數解析其操作 QoS 參數。 迷你埠驅動程式也可以根據獨立硬體廠商所定義的任何專屬 QoS 設定來解析其運作 QoS 參數, (IHV) 。
如果未設定此旗標,迷你埠驅動程式必須停用本機 DCBX 願意狀態。 這可讓驅動程式從本機 QoS 參數解析其操作 QoS 參數,而不是遠端 QoS 參數。 迷你埠驅動程式也必須停用或覆寫未設定相關 NDIS_QOS_PARAMETERS_Xxx_CONFIGURED 旗標的任何本機 QoS 參數。
例如,迷你埠驅動程式可以使用 IHV 所定義的 QoS 參數專屬設定來覆寫未設定的本機 QoS 參數。 如果未使用 NDIS_QOS_PARAMETERS_Xxx 指定本機 QoS 參數的專屬設定_CONFIGURED旗標,驅動程式必須在網路介面卡上停用這些 QoS 參數的使用。
注意 如果驅動程式危害網路介面卡上啟用的通訊協定或技術所使用的 QoS 參數,驅動程式也可以覆寫設定的本機 QoS 參數。 例如,如果網路介面卡已啟用透過乙太網路的光纖通道進行遠端開機,則驅動程式可以覆寫本機 QoS 參數 (FCoE) 通訊協定。
如需本機 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結構的一或多個成員包含不正確的值。 |
NDIS_STATUS_INVALID_LENGTH |
資訊緩衝區的長度小於 sizeof (NDIS_QOS_PARAMETERS) 。 NDIS 會設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,以達到所需的最小緩衝區大小。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
規格需求
版本 |
NDIS 6.30 和更新版本支援。 |
標頭 |
Ntddndis.h (包括 Ndis.h) |