處理OID_NIC_SWITCH_CREATE_SWITCH要求

NDIS 發出物件識別碼 (OID) 方法要求， OID_NIC_SWITCH_CREATE_SWITCH 執行下列動作：

• 針對 PCI Express (PCIe) 實體函式 (PF) ，在迷你埠驅動程式靜態建立的網路介面卡上啟用 NIC 交換器。 PF 是網路介面卡的硬體元件，可支援單一根目錄 I/O 虛擬化 (SR-IOV) 。

  NIC 參數會由 PF 迷你埠驅動程式從內容中靜態建立，以呼叫 MiniportInitializeEx。 驅動程式會配置資源，並根據從登錄設定讀取的參數建立參數。

• 在網路介面卡上動態建立 NIC 交換器。

  如果 PF 迷你埠驅動程式不支援靜態 NIC 交換器建立，迷你埠驅動程式會配置資源，並根據 OID 要求中指定的參數建立交換器。

當 NDIS 呼叫驅動程式 的 MiniportInitializeEx 函式時，PF 迷你埠驅動程式會公告其 SR-IOV 介面的支援。 如果 PF 迷你埠驅動程式支援 SR-IOV，NDIS 會從登錄讀取 NIC 交換器組態。 在 NDIS 向 PF 迷你埠驅動程式發出 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 方法要求之前，NDIS 會以下列方式，使用登錄資訊來格式化 NDIS_NIC_SWITCH_PARAMETERS 結構：

• NDIS 會將 SwitchType 成員設定為 NIC 參數的類型。

  從 Windows Server 2012 開始，Windows 僅支援NdisNicSwitchTypeExternal的切換類型。 外部交換器會指定連線到這種交換器的虛擬埠 (VPorts) 可以透過網路介面卡上的實體埠來存取外部網路。

  如需 NIC 參數的詳細資訊，請參閱 SR-IOV 架構。

• NDIS 會將 SwitchId 成員設定為 NIC 參數的識別碼值。 交換器識別碼是介於零與網路介面卡支援的交換器數目之間的整數。 NDIS_DEFAULT_SWITCH_ID值表示預設的 NIC 參數。

  注意從 Windows Server 2012 開始，SR-IOV 介面僅支援網路介面卡上的預設 NIC 交換器。

• NDIS 會設定 NumVFs 成員，指定可在 NIC 交換器上配置的 PCIe 虛擬函式 (VFs 數目) 。

當它收到 OID_NIC_SWITCH_CREATE_SWITCH的 OID 方法要求時，PF 迷你埠驅動程式必須執行下列動作：

1. 如果 PF 迷你埠驅動程式支援靜態交換器建立和設定，則會在 NDIS 呼叫 MiniportInitializeEx時建立 NIC 參數。 當驅動程式處理此 OID 要求時，它必須驗證 NDIS_NIC_SWITCH_PARAMETERS 結構中的組態參數。 參數必須與驅動程式用來在 呼叫 MiniportInitializeEx期間建立切換的參數相同。 如果這不是 true，則驅動程式必須失敗 OID 要求。

   如需詳細資訊，請參閱 靜態建立 NIC 參數。

2. 如果 PF 迷你埠驅動程式支援動態交換器建立和設定，驅動程式必須驗證 NDIS_NIC_SWITCH_PARAMETERS 結構的組態值，並根據這些值建立 NIC 交換器。

   如需詳細資訊，請參閱 動態建立 NIC 交換器。

3. PF 迷你埠驅動程式必須為 NIC 交換器上的預設 VPort 配置必要的硬體和軟體資源。

   注意 預設 VPort 一律會透過 OID_NIC_SWITCH_CREATE_SWITCH 的 OID 要求建立，並透過 OID_NIC_SWITCH_DELETE_SWITCH的 OID 要求刪除。 OID 要求 OID_NIC_SWITCH_CREATE_VPORT 和 OID_NIC_SWITCH_DELETE_VPORT 用於在 NIC 交換器上建立和刪除非預設 VPorts。

4. 支援動態交換器建立和設定的 PF 迷你埠驅動程式必須藉由呼叫 NdisMEnableVirtualization，在交換器上啟用 SR-IOV 虛擬化。 此呼叫會在介面卡 PCI Express (PCIe) 設定空間的 SR-IOV 擴充功能結構中設定 NumVFs 成員和 VF Enable 位。

   如需 SR-IOV 設定空間的詳細資訊，請參閱 PCI-SIG 單一根目錄 I/O 虛擬化和共用 1.1 規格。

   注意 如果 PF 迷你埠驅動程式支援靜態交換器建立，它會在呼叫 MiniportInitializeEx 時建立交換器之後啟用 SR-IOV 虛擬化。

如果 PF 迷你埠驅動程式成功完成OID_NIC_SWITCH_CREATE_SWITCH的 OID 方法要求，則會允許進行下列動作：

• VFS 可以透過 OID_NIC_SWITCH_ALLOCATE_VF的 OID 方法要求，在 NIC 交換器上配置。

• 您可以透過 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法要求，在 NIC 交換器上建立非預設 VPorts。

  迷你埠驅動程式負責管理其非預設 VPorts 集區。 驅動程式會透過NDIS_NIC_SWITCH_INFO結構的NumVPorts成員，指定其集區中的非預設 VPorts 數目。 驅動程式會透過 OID_NIC_SWITCH_ENUM_SWITCHES的 OID 查詢要求傳回此結構。

  注意 網路介面卡必須一律從 PF 的集區建立預設 VPort。