OID_NDK_SET_STATE

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

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

言论

NDIS 将此 OID 与指向 BOOLEANNDIS_OID_REQUEST 结构的 InformationBuffer 成员发出此 OID,InformationBufferLength 成员等于 sizeof(BOOLEAN)。

  • 如果 BOOLEANTRUE,并且 *NetworkDirect 关键字值为非零,则必须启用微型端口适配器的 NDK 功能。

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

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

    2. 调用 NdisReadConfiguration,并传递:

      • Keyword 参数的“*NetworkDirect”

      • ParameterType 参数的 NdisParameterInteger

  • 如果 BOOLEANFALSE,则必须禁用微型端口适配器的 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