列舉網路適配器上的 NIC 交換器

過度配置驅動程式或使用者應用程式可以取得已在支援單一根 I/O 虛擬化 （SR-IOV） 之網路適配器上建立的所有 NIC 交換器清單。 驅動程式或應用程式發出 OID_NIC_SWITCH_ENUM_SWITCHES 的物件識別碼 （OID） 查詢要求，以取得此清單。

從成功完成這個 OID 要求後，結構 NDIS_OID_REQUEST 的成員 InformationBuffer 會包含一個指向緩衝區的指標，該指標包括以下內容：

• 定義陣列內元素數目的 NDIS_NIC_SWITCH_INFO_ARRAY 結構。

• 一組 NDIS_NIC_SWITCH_INFO 結構。 每個結構都包含網路適配器上所建立之單一 NIC 交換器的相關信息。

  注意 如果網路適配器沒有 NIC 參數，驅動程式會將 NDIS_NIC_SWITCH_INFO_ARRAY 結構 成員 NumElements 設定為零，而且不會傳回任何 NDIS_NIC_SWITCH_INFO 結構。

注意 從 Windows Server 2012 開始，SR-IOV 介面僅支援網路適配器上的一個 NIC 交換器。 這個交換器稱為 預設 NIC 交換器，並由 NDIS_DEFAULT_SWITCH_ID 識別符參考。

NDIS 會處理迷你埠驅動程式的 OID_NIC_SWITCH_ENUM_SWITCHES 要求。 NDIS 會從它從下列來源維護之數據的內部快取傳回資訊：

• 登錄中標準化 SR-IOV 關鍵詞設定。 如需這些關鍵詞的詳細資訊，請參閱 SR-IOV的標準化 INF 關鍵詞。

• OID_NIC_SWITCH_CREATE_SWITCH 和 OID_NIC_SWITCH_PARAMETERS的 OID 要求。

Note NDIS 也在 NDIS_BIND_PARAMETERS 和 NDIS_FILTER_ATTACH_PARAMETERS 結構中提供 NicSwitchArray 成員的開關列舉。 因此，上層通訊協定和篩選驅動程式不需要發出 OID_NIC_SWITCH_ENUM_SWITCHES 要求來取得這項資訊。