OID_NIC_SWITCH_ENUM_SWITCHES
過度的驅動程式或使用者模式應用程式發出OID_NIC_SWITCH_ENUM_SWITCHES的物件識別碼 (OID) 查詢要求,以取得數位。 陣列中的每個元素都會指定已在網路適配器上建立之 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 專案,而預設 NIC 參數是由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。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |