共用方式為


OID_NIC_SWITCH_DELETE_VPORT

過度配置驅動程式會發出物件識別碼 (OID) 設定 OID_NIC_SWITCH_DELETE_VPORT要求,以刪除先前在網路介面卡的 NIC 交換器上建立的非預設虛擬埠 (VPort) 。 過度處理驅動程式可以刪除先前只透過發出 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法要求來建立的 VPort。

過度處理驅動程式會將此 OID 設定要求傳送給網路介面卡 PCIe 實體函式的迷你埠驅動程式, (PF) 。 支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的 PF 迷你埠驅動程式需要此 OID 集合要求。

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

備註

過度配置驅動程式,例如通訊協定或篩選驅動程式,只能刪除先前建立的非預設 VPort。 超載驅動程式會發出 OID_NIC_SWITCH_CREATE_VPORT的 OID 方法要求,以建立 VPort。

當 PF 迷你埠驅動程式收到OID_NIC_SWITCH_DELETE_VPORT的 OID 要求時,驅動程式必須釋放為指定 VPort 配置的硬體和軟體資源。

如需詳細資訊,請參閱 刪除虛擬埠

注意 只有非預設 VPorts 可以透過OID_NIC_SWITCH_DELETE_VPORT的 OID 要求明確刪除。 當 PF 迷你埠驅動程式刪除預設的 NIC 參數時,會隱含刪除預設 VPort。 如需詳細資訊,請參閱 刪除 NIC 交換器

傳回狀態碼

PF 迷你埠驅動程式會針對 OID_NIC_SWITCH_DELETE_VPORT 的 OID 集合要求,傳回下列其中一個狀態碼。

狀態碼 描述

NDIS_STATUS_SUCCESS

OID 要求已成功完成。

NDIS_STATUS_NOT_SUPPORTED

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

NDIS_STATUS_INVALID_PARAMETER

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

NDIS_STATUS_INVALID_LENGTH

資訊緩衝區的長度小於大小 (NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS) 。 PF 迷你埠驅動程式必須設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員,以達到所需的最小緩衝區大小。

NDIS_STATUS_FAILURE

要求因其他原因而失敗。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

Ntddndis.h (包括 Ndis.h)

另請參閱


NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH