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) 值:
使用初始化微型端口驱动程序时 NdisMRegisterMiniportDriver 函数返回的 NDIS 句柄调用 NdisOpenConfigurationEx。 有关调用 NdisOpenConfigurationEx 的详细信息,请参阅 在 NDIS 6.0 微型端口驱动程序中读取注册表。
调用 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) |