共用方式為


OID_NIC_SWITCH_VPORT_PARAMETERS

過度配置驅動程式可以在支援單一根目錄 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_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_VPORTOID_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 結構的下列成員來指定要變更的參數:

  1. VPortId成員會設定為將變更其參數之 VPort 的識別碼。

  2. 適當的NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED旗標是在 Flags 成員中設定。 只有在 Ntddndis.h 中定義對應的 NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED 旗標時,才能變更NDIS_NIC_SWITCH_VPORT_PARAMETERS結構的成員。

  3. 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

要求因其他原因而失敗。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

Ntddndis.h (包含 Ndis.h)

另請參閱


NDIS_NIC_SWITCH_VPORT_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_VPORTS