OID_NIC_SWITCH_VPORT_PARAMETERS

發行項
06/15/2023

過度配置驅動程式可以在支援單一根目錄 I/O 虛擬化 (SR-IOV) 的網路介面卡上建立的 NIC 交換器上，取得虛擬埠 (VPort) 的參數。驅動程式會發出物件識別碼， (OID) 方法要求OID_NIC_SWITCH_VPORT_PARAMETERS以取得這些參數。

過度配置驅動程式發出OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集合要求，以設定附加至網路介面卡 NIC 交換器之指定 VPort 的組態參數。這些 OID 集合要求會發出給網路介面卡 PCI Express (PCIe) 實體函式 (PF) 的迷你埠驅動程式。支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的 PF 迷你埠驅動程式需要這些 OID 集合要求。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的指標。

過度配置驅動程式會將NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的 VPort 成員設定為與 VPort 相關聯的識別碼，以指定 OID 方法的VPort或設定要求。過度處理驅動程式會透過下列其中一種方式取得 VPort 識別碼：

從先前的 OID 方法要求 OID_NIC_SWITCH_CREATE_VPORT。
從先前的 OID 方法要求 OID_NIC_SWITCH_ENUM_VPORTS。

備註

OID_NIC_SWITCH_VPORT_PARAMETERS可用於 OID 方法要求或 OID 集合要求。

處理 OID_NIC_SWITCH_VPORT_PARAMETERS 的 OID 方法要求

過度調整驅動程式發出OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 方法要求，以查詢附加至網路介面卡 NIC 交換器之 VPort 的目前組態參數。過度配置驅動程式會將NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的VPortId成員設定為 VPort 識別碼，以指定要查詢的 VPort。

NDIS 會處理迷你埠驅動程式OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 方法要求。 NDIS 會傳回從先前 OID_NIC_SWITCH_CREATE_VPORT 和 OID_NIC_SWITCH_ENUM_VPORTS OID 要求取得的資訊。

從 OID 方法要求成功傳回之後，NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的指標。這個結構包含指定之參數的組態參數。

如需詳細資訊，請參閱查詢虛擬埠的參數。

處理OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集合要求

過度調整驅動程式發出OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集合要求，以變更附加至網路介面卡 NIC 交換器之 VPort 的目前組態參數。此 OID 要求可用來更新預設和非預設 VPorts 的參數。

只能變更 VPort 的有限組態參數子集。過度配置驅動程式會藉由設定 NDIS_NIC_SWITCH_VPORT_PARAMETERS 結構的下列成員來指定要變更的參數：

VPortId成員會設定為將變更其參數之 VPort 的識別碼。
適當的NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED旗標是在 Flags 成員中設定。只有在 Ntddndis.h 中定義對應的 NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED 旗標時，才能變更NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的成員。
NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的對應成員會設定為要變更的 VPort 組態參數。

在 PF 迷你埠驅動程式收到OID_NIC_SWITCH_VPORT_PARAMETERS的 OID 集合要求之後，驅動程式會使用組態參數來設定硬體。驅動程式只能變更NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx所識別的組態參數_CHANGED NDIS_NIC_SWITCH_VPORT_PARAMETERS結構之Flags成員中的旗標。

如需詳細資訊，請參閱設定虛擬埠的參數。

傳回狀態碼

NDIS 或 PF 迷你埠驅動程式會針對OID_NIC_SWITCH_VPORT_PARAMETERS的 set 或方法 OID 要求傳回下列狀態碼。

狀態碼	描述
NDIS_STATUS_SUCCESS	要求已順利完成。 InformationBuffer指向NDIS_NIC_SWITCH_CAPABILITIES結構。
NDIS_STATUS_NOT_SUPPORTED	PF 迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面，或未啟用該介面。
NDIS_STATUS_INVALID_PARAMETER	NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的一或多個成員具有不正確值。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太短。 NDIS 或 PF 迷你埠驅動程式會設定資料。METHOD_INFORMATION。 OID 方法要求) 或 DATA 的 BytesNeeded 成員 (。SET_INFORMATION。 NDIS_OID_REQUEST 結構中 OID 設定要求) 的 BytesNeeded 成員 ( 為所需的緩衝區大小下限。
NDIS_STATUS_FAILURE	要求因其他原因而失敗。