共用方式為


OID_NIC_SWITCH_ALLOCATE_VF

過度處理驅動程式會發出物件識別碼 (OID) 方法 OID_NIC_SWITCH_ALLOCATE_VF要求,以配置 PCI Express (PCIe (PCIe) Virtual Function (VF) 的資源。 VF 會在支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的網路介面卡上公開。

過度使用驅動程式向網路介面卡 PCIe 實體函式的迷你埠驅動程式發出此 OID 方法要求, (PF) 。 PF 迷你埠驅動程式需要此 OID 方法要求,這些驅動程式支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面。

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

備註

當驅動程式處理物件識別碼 (OID) 方法 OID_NIC_SWITCH_ALLOCATE_VF要求時,PF 迷你埠驅動程式會為 VF 配置軟體資源。 即使硬體資源已配置給 VF,它仍會被視為非操作,直到 PF 迷你埠驅動程式成功完成OID_NIC_SWITCH_ALLOCATE_VF為止。

如需如何配置 VF 資源的詳細資訊,請參閱 配置虛擬函式的資源

注意 在過度配置驅動程式要求 VF 的資源配置之後,該驅動程式是唯一可以要求釋放相同 VF 之資源的元件。 過度處理驅動程式必須發出 OID_NIC_SWITCH_FREE_VF 的 OID 集合要求,以釋放 VF 資源。 在過度配置驅動程式停止之前,它必須釋放驅動程式OID_NIC_SWITCH_ALLOCATE_VF要求所配置之每個 VF 的資源。

傳回狀態碼

PF 迷你埠驅動程式會針對 OID_NIC_SWITCH_ALLOCATE_VF 的 OID 方法要求傳回下列其中一個狀態碼。

狀態碼 描述

NDIS_STATUS_SUCCESS

OID 要求已順利完成。

NDIS_STATUS_NOT_SUPPORTED

PF 迷你埠驅動程式不支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面,或未啟用該介面。

NDIS_STATUS_INVALID_PARAMETER

NDIS_NIC_SWITCH_VF_PARAMETERS結構的一或多個成員具有不正確值。

NDIS_STATUS_INVALID_LENGTH

資訊緩衝區的長度小於 sizeof (NDIS_NIC_SWITCH_VF_PARAMETERS) 。 PF 迷你埠驅動程式必須設定DATA。METHOD_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,到所需的緩衝區大小下限。

NDIS_STATUS_FAILURE

要求因其他原因而失敗。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

Ntddndis.h (包含 Ndis.h)

另請參閱


NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF