OID_NIC_SWITCH_DELETE_SWITCH

NDIS 发出对象标识符 (OID) OID_NIC_SWITCH_DELETE_SWITCH从网络适配器中删除 NIC 交换机的请求集。

NDIS 向网络适配器的 PCI Express (PCIe) 物理功能 (PF) 的微型端口驱动程序发出此 OID 集请求。支持单根 I/O 虚拟化 (SR-IOV) 接口的 PF 微型端口驱动程序需要此 OID 集请求。

注意过度分配驱动程序（如协议或筛选器驱动程序）无法向 PF 微型端口驱动程序发出此 OID 方法请求。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向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，并将 NumVFs 参数设置为零。

NdisMEnableVirtualization 在网络适配器的 PF 的 PCI 配置空间中清除 SR-IOV 扩展功能结构中的 NumVFs 成员和 VF Enable 位。

注意如果 PF 微型端口驱动程序支持静态创建和配置 NIC 交换机，则它必须仅在调用 MiniportHaltEx 时调用 NdisMEnableVirtualization。

有关详细信息，请参阅删除 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 设置数据。SET_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。