OID_NIC_SWITCH_DELETE_SWITCH
NDIS 會發出OID_NIC_SWITCH_DELETE_SWITCH的物件標識碼 (OID) 集合要求,以從網路適配器刪除 NIC 交換器。
NDIS 會發出此 OID 設定要求給網路適配器 PCI Express (PCIe) 實體函式 (PF) 的迷你埠驅動程式。 支援單一根 I/O 虛擬化 (SR-IOV) 介面的 PF 迷你埠驅動程式需要此 OID 集合要求。
注意 過度配置驅動程式,例如通訊協定或篩選驅動程式,無法對 PF 迷你埠驅動程式發出這個 OID 方法要求。
InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS 結構的指標。
言論
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,並將 NumVF 參數設定為零。
NdisMEnableVirtualization 會清除 NumVFs 成員,以及網路適配器 PF 之 PCI 組態空間中 SR-IOV 擴充功能結構的 VF Enable 位。
注意 如果 PF 迷你埠驅動程式支援靜態建立和設定 NIC 參數,則呼叫 NdisMEnableVirtualization 時,MiniportHaltEx。
如需詳細資訊,請參閱 刪除 NIC 交換器。
傳回狀態代碼
迷你埠驅動程式的 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。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |