OID_NIC_SWITCH_DELETE_SWITCH

NDIS 發出物件識別碼， (OID) 設定OID_NIC_SWITCH_DELETE_SWITCH要求，以從網路介面卡刪除 NIC 交換器。

NDIS 會將此 OID 設定要求發出給網路介面卡 PCI Express (PCIe 的迷你埠驅動程式，) 實體函式 (PF) 。支援單一根目錄 I/O 虛擬化 (SR-IOV) 介面的 PF 迷你埠驅動程式需要此 OID 集合要求。

注意過度配置驅動程式，例如通訊協定或篩選驅動程式，無法對 PF 迷你埠驅動程式發出這個 OID 方法要求。

備註

OID_NIC_SWITCH_DELETE_SWITCH的 OID 集合要求會刪除先前透過 OID_NIC_SWITCH_CREATE_SWITCH的 OID 方法要求所建立的 NIC 參數。

當它收到 OID_NIC_SWITCH_DELETE_SWITCH 的 OID 方法要求時，PF 迷你埠驅動程式必須執行下列動作：

如果 PF 迷你埠驅動程式支援靜態建立和設定 NIC 交換器，則必須釋放與指定 NIC 交換器相關聯的軟體資源。不過，呼叫 MiniportHaltEx 時，驅動程式只能釋放 NIC 參數的硬體資源。

如需靜態 NIC 交換器建立的詳細資訊，請參閱靜態建立 NIC 交換器。
如果 PF 迷你埠驅動程式支援動態建立和設定 NIC 交換器，則必須釋放與指定 NIC 交換器相關聯的硬體和軟體資源。

如需動態 NIC 交換器建立的詳細資訊，請參閱動態建立 NIC 交換器。
如果 PF 迷你埠驅動程式支援動態建立，而且所有 NIC 交換器都已刪除，驅動程式必須藉由呼叫 NdisMEnableVirtualization來停用介面卡上的虛擬化。若要停用虛擬化，網路介面卡必須將 EnableVirtualization 參數設定為 FALSE，並將 NumVFs 參數設定為零。

NdisMEnableVirtualization 會在網路介面卡的 PF 的 PCI 組態空間中清除 SR-IOV 擴充功能結構的 NumVF 成員和 VF Enable 位。

注意如果 PF 迷你埠驅動程式支援靜態建立和設定 NIC 交換器，則只有在呼叫MiniportHaltEx時，才必須呼叫NdisMEnableVirtualization。

如需詳細資訊，請參閱刪除 NIC 交換器。

miniport 驅動程式的 MiniportOidRequest 函式會針對此要求傳回下列其中一個值：

詞彙	描述
NDIS_STATUS_SUCCESS	迷你埠驅動程式已成功完成要求。
NDIS_STATUS_PENDING	迷你埠驅動程式會以非同步方式完成要求。迷你埠驅動程式完成所有處理之後，它必須藉由呼叫NdisMOidRequestComplete函式來成功要求，並傳遞Status參數的NDIS_STATUS_SUCCESS。
NDIS_STATUS_NOT_ACCEPTED	迷你埠驅動程式已重設。
NDIS_STATUS_REQUEST_ABORTED	迷你埠驅動程式已停止處理要求。例如，NDIS 稱為 MiniportResetEx 函式。

NDIS 會針對此要求傳回下列其中一個狀態碼：

詞彙	描述
NDIS_STATUS_SUCCESS	OID 要求已成功完成。
NDIS_STATUS_NOT_SUPPORTED	PF 迷你埠驅動程式不支援 SR-IOV 介面，或未啟用該介面。
NDIS_STATUS_FILE_NOT_FOUND	NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS結構的一或多個成員具有不正確值。
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區太小。 NDIS 會設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，以達到所需的最小緩衝區大小。