OID_SWITCH_PORT_CREATE

Hyper-V 可扩展交换机的协议边缘发出对象标识符 (OID) OID_SWITCH_PORT_CREATE集请求，以通知可扩展交换机扩展创建可扩展交换机端口。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_SWITCH_PORT_PARAMETERS 结构的指针。

注解

NDIS_SWITCH_PORT_PARAMETERS 结构的 PortId 成员指定要向其发出创建通知的端口。

可扩展开关扩展必须遵循以下准则来处理OID_SWITCH_PORT_CREATE的 OID 集请求：

该扩展不得修改与 OID 请求关联的 NDIS_SWITCH_PORT_PARAMETERS 结构。
扩展可以通过返回 OID 请求的NDIS_STATUS_DATA_NOT_ACCEPTED来否决创建通知。例如，如果扩展无法分配资源以在端口上强制实施其配置的策略，则驱动程序应否决创建通知。

如果扩展返回其他 NDIS_STATUS_Xxx 错误状态代码，则创建通知也会被否决。但是，返回临时方案的状态代码（如返回NDIS_STATUS_RESOURCES）可能会导致创建通知的重试。

如果扩展未否决 OID 请求，则应在请求完成时监视状态。扩展应执行此操作以确定 OID 请求是被可扩展开关控制路径中的基础扩展否决的，还是被可扩展开关接口否决的。

有关端口策略的详细信息，请参阅管理 Hyper-V 可扩展交换机策略。
如果扩展调用 NdisFOidRequest 来转发此 OID 集请求，则扩展应监视此 OID 请求的完成状态。扩展执行此操作可以检测可扩展交换机驱动程序堆栈中的基础扩展是否已否决了端口创建通知。
转发 OID 请求并成功完成后，扩展可以针对端口发出 OID 请求，例如 OID_SWITCH_PORT_PROPERTY_ENUM，直到发出 OID_SWITCH_PORT_TEARDOWN 的 OID 请求。此 OID 请求通知扩展，端口将从可扩展交换机开始删除过程。
在发出 OID_SWITCH_NIC_CONNECT 的 OID 集请求并成功完成之前，扩展无法将数据包转发到 NDIS_SWITCH_PORT_PARAMETERS 结构中的指定端口。

注意扩展不得发出OID_SWITCH_PORT_CREATE的 OID 集请求。

有关可扩展交换机端口和网络适配器连接状态的详细信息，请参阅 Hyper-V 可扩展交换机端口和网络适配器状态。

如果扩展完成 OID_SWITCH_PORT_CREATE 的 OID 集请求，它将返回以下状态代码之一。

状态代码	说明
NDIS_STATUS_DATA_NOT_ACCEPTED	扩展已否决创建通知。
NDIS_STATUS_RESOURCES	由于资源不足，扩展否决了创建通知。
NDIS_STATUS_Xxx	扩展出于其他原因否决了创建通知。