共用方式為

設定 NIC 參數的參數

  • 發行項

過度配置驅動程式可以變更已在支援單一根目錄 I/O 虛擬化 (SR-IOV) 之網路介面卡上建立的 NIC 交換器參數。 驅動程式會發出物件識別碼， (OID) 設定 OID_NIC_SWITCH_PARAMETERS 要求來變更這些參數。 只有 PCI Express (PCIe 的迷你埠驅動程式) 實體函式 (SR-IOV 介面卡的 PF) 會處理此 OID 集合要求。

在過度處理驅動程式發出此 OID 集合要求之前，它必須先初始化 NDIS_NIC_SWITCH_PARAMETERS 結構，並在 NIC 參數上變更參數。 驅動程式接著會初始化 OID 要求的 NDIS_OID_REQUEST 結構，並將 InformationBuffer 成員設定為 NDIS_NIC_SWITCH_PARAMETERS 結構的指標。

只能變更 NIC 參數的有限組態參數子集。 過度配置驅動程式會藉由設定 NDIS_NIC_SWITCH_PARAMETERS 結構的下列成員來指定要變更的參數：

  • SwitchId成員會設定為將變更其參數之 NIC 參數的識別碼。

    注意從 Windows Server 2012 開始，SR-IOV 介面僅支援網路介面卡上的一個 NIC 交換器。 此參數稱為 預設 NIC 參數。 SwitchId成員必須設定為 NDIS_DEFAULT_SWITCH_ID。

  • 適當的NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED旗標是在 Flags 成員中設定。 只有在 Ntddndis.h 中定義對應的 NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED 旗標時，才能變更NDIS_NIC_SWITCH_PARAMETERS結構的成員。

  • NDIS_NIC_SWITCH_PARAMETERS結構的成員會與Flags成員中所設定的 NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED旗標一起設定，並使用要變更的 NIC 參數組態參數來設定。

    注意從 Windows Server 2012 開始，只有NDIS_NIC_SWITCH_PARAMETERS結構的SwitchName成員可以透過OID_NIC_SWITCH_PARAMETERS的 OID 集合要求來變更。

當 PF 迷你埠驅動程式收到OID_NIC_SWITCH_PARAMETERS的 OID 集合要求時，必須遵循這些指導方針

  • 如果 PF 迷你埠驅動程式可以套用變更，而不需要重新初始化網路介面卡，驅動程式會將變更套用至硬體，並使用 NDIS_STATUS_SUCCESS 完成 OID 要求。

    如果傳回此狀態碼，NDIS 會更新登錄中的 NIC 交換器組態資訊。

  • 如果 PF 迷你埠驅動程式需要重新初始化網路介面卡以套用變更，驅動程式就會使用 NDIS_STATUS_REINIT_REQUIRED 完成 OID 要求。

    如果傳回此狀態碼，NDIS 也會更新登錄中的 NIC 交換器組態資訊。 不過，發出 OID 集合要求的過度驅動程式必須重新初始化網路介面卡，變更才會生效。

    注意 支援靜態 NIC 建立和設定的 PF 迷你埠驅動程式可以傳回NDIS_STATUS_REINIT_REQUIRED，以確保重新初始化配接器，讓新參數生效。

  • 如果 PF 迷你埠驅動程式無法套用 OID 中要求的變更，它必須失敗 OID 並傳回適當的NDIS_STATUS_Xxx 程式碼。

    在此情況下，NDIS 不會更新登錄中的 NIC 交換器組態資訊。