OID_NIC_SWITCH_ENUM_SWITCHES

發行項
06/15/2023

過度運用的驅動程式或使用者模式應用程式會發出物件識別碼， (OID) 查詢要求OID_NIC_SWITCH_ENUM_SWITCHES以取得陣列。陣列中的每個元素都會指定已在網路介面卡上建立之 NIC 交換器的屬性。

從這個 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結構。

備註

過度處理驅動程式和使用者模式應用程式會發出 OID 查詢要求，OID_NIC_SWITCH_ENUM_SWITCHES列舉網路介面卡上建立的 NIC 交換器。

注意從 Windows Server 2012 開始，單一根目錄 I/O 虛擬化 (SR-IOV) 介面僅支援網路介面卡上的預設 NIC 交換器。因此，傳回 NDIS_NIC_SWITCH_INFO_ARRAY 結構必須指定預設 NIC 參數的單一 NDIS_NIC_SWITCH_INFO 元素，此參數是由NDIS_DEFAULT_SWITCH_ID的識別碼所參考。

傳回狀態碼

NDIS 會處理迷你埠驅動程式OID_NIC_SWITCH_ENUM_SWITCHES要求的 OID 查詢要求。驅動程式將不會發出此 OID 要求。

當 NDIS 處理OID_NIC_SWITCH_ENUM_SWITCHES要求時，它會傳回下列其中一個狀態碼。

狀態碼	描述
NDIS_STATUS_SUCCESS	OID 要求已成功完成。
NDIS_STATUS_NOT_SUPPORTED	迷你埠驅動程式不支援 SR-IOV 介面，或未啟用該介面。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_INFO_ARRAY結構的一或多個成員具有不正確值。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太短。 NDIS 會設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，以達到所需的最小緩衝區大小。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。