OID_NDK_SET_STATE

作为设置请求，NDIS 和超置驱动程序使用 OID_NDK_SET_STATE OID 来设置微型端口适配器的 NDK 功能的状态。

提供 NDK 服务的 NDIS 6.30 及更高版本的微型端口驱动程序必须支持此 OID。 否则，此 OID 是可选的。

注解

NDIS 使用指向 BOOLEAN 和 informationBufferLength 成员的 NDIS_OID_REQUEST 结构的 InformationBuffer 成员颁发此 OID，该成员的大小等于 (BOOLEAN) 。

• 如果 BOOLEAN 值为 TRUE 且 *NetworkDirect 关键字 (keyword) 值为非零值，则必须启用微型端口适配器的 NDK 功能。

  微型端口驱动程序可以通过执行以下操作来读取 *NetworkDirect 关键字 (keyword) 值：

  1. 使用初始化微型端口驱动程序时 NdisMRegisterMiniportDriver 函数返回的 NDIS 句柄调用 NdisOpenConfigurationEx。 有关调用 NdisOpenConfigurationEx 的详细信息，请参阅 在 NDIS 6.0 微型端口驱动程序中读取注册表。

  2. 调用 NdisReadConfiguration，传递：

     • Keyword 参数的“*NetworkDirect”

     • ParameterType 参数的 NdisParameterInteger

• 如果 BOOLEAN 值为 FALSE，则必须禁用微型端口适配器的 NDK 功能。

若要启用或禁用其 NDK 功能，微型端口驱动程序的 MiniportOidRequest 回调函数应遵循 启用和禁用 NDK 功能中的步骤。

注意支持 NDK 的微型端口驱动程序绝不能从其 MiniportOidRequest 函数的上下文调用 NdisMNetPnPEvent，因为这样做可能会导致死锁。 相反，它应从其他某个上下文调用 NdisMNetPnPEvent 或将工作项排队。

除非发生故障，否则支持 NDK 的微型端口驱动程序的 MiniportOidRequest 函数必须为OID_NDK_SET_STATE OID 请求返回STATUS_SUCCESS 。 驱动程序不得返回 NDIS_STATUS_PENDING。

要求

最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2012
版本	在 NDIS 6.30 及更高版本中受支持。
标头	Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE