OID_NDK_SET_STATE

Como solicitud establecida, los controladores NDIS y los controladores de exceso usan el OID de OID_NDK_SET_STATE para establecer el estado de la funcionalidad del NDK del adaptador de miniporte.

Los controladores de minipuerto NDIS 6.30 y versiones posteriores que proporcionan servicios NDK deben admitir este OID. De lo contrario, este OID es opcional.

Observaciones

NDIS emite este OID con el miembro InformationBuffer de la estructura NDIS_OID_REQUEST que apunta a un miembro BOOLEAN e InformationBufferLength igual a sizeof(BOOLEAN).

• Si el valor BOOLEAN es TRUE y el valor de la palabra clave *NetworkDirect es distinto de cero, se debe habilitar la funcionalidad NDK del adaptador de miniporte.

  El controlador de minipuerto puede leer el valor de palabra clave *NetworkDirect haciendo lo siguiente:

  1. Llame a NdisOpenConfigurationEx con el identificador NDIS que la función NdisMRegisterMiniportDriver devolvió cuando se inicializó el controlador de miniport. Para obtener más información sobre cómo llamar a NdisOpenConfigurationEx, consulte Lectura del Registro en un controlador miniporte NDIS 6.0.

  2. Llame a NdisReadConfiguration y pase:

     • "*NetworkDirect" para el parámetro Keyword

     • NdisParameterInteger para el parámetro ParameterType

• Si el valor BOOLEAN es FALSE, se debe deshabilitar la funcionalidad NDK del adaptador de miniporte.

Para habilitar o deshabilitar su funcionalidad de NDK, la función de devolución de llamada MiniportOidRequest del controlador de miniporte debe seguir los pasos descritos en Habilitación y deshabilitación de la funcionalidad de NDK.

Nota Un controlador de miniporte compatible con NDK nunca debe llamar a NdisMNetPnPEvent desde el contexto de su función MiniportOidRequest , ya que hacerlo podría provocar un interbloqueo. En su lugar, debe llamar a NdisMNetPnPEvent desde algún otro contexto o poner en cola un elemento de trabajo.

La función MiniportOidRequest del controlador de miniporte compatible con NDK debe devolver STATUS_SUCCESS para una solicitud de OID de OID_NDK_SET_STATE a menos que se produzca un error. El controlador no debe devolver NDIS_STATUS_PENDING.

Requisitos

Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2012
Versión	Se admite en NDIS 6.30 y versiones posteriores.
Encabezado	Ntddndis.h (incluye Ndis.h)

Consulte también

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE