OID_NIC_SWITCH_DELETE_VPORT
過度配置驅動程式會發出OID_NIC_SWITCH_DELETE_VPORT的物件標識碼 (OID) 集合要求,以刪除先前在網路適配器 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 要求明確刪除OID_NIC_SWITCH_DELETE_VPORT。 當 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 |
信息緩衝區的長度小於sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS)。 PF 迷你埠驅動程序必須設定 數據。SET_INFORMATION。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |