列舉網路介面卡上的 NIC 交換器
過度使用的驅動程式或使用者應用程式可以取得網路介面卡上建立的所有 NIC 交換器清單,該交換器支援單一根目錄 I/O 虛擬化 (SR-IOV) 。 驅動程式或應用程式會發出物件識別碼, (OID) 查詢要求 OID_NIC_SWITCH_ENUM_SWITCHES 以取得此清單。
從這個 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 要求。
注意NDIS 也提供NDIS_BIND_PARAMETERS和NDIS_FILTER_ATTACH_PARAMETERS結構中NicSwitchArray成員中的參數列舉。 因此,過度的通訊協定和篩選驅動程式不需要發出 OID_NIC_SWITCH_ENUM_SWITCHES 要求來取得這項資訊。