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