處理OID_NIC_SWITCH_CREATE_SWITCH要求

NDIS 發出OID_NIC_SWITCH_CREATE_SWITCH的物件識別碼 （OID） 方法要求，以執行下列動作：

• 在由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 方法要求OID_NIC_SWITCH_CREATE_SWITCH之前，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 方法要求，則會允許發生下列情況：

• VF 可以透過 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。