OID_NDK_SET_STATE

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

Los controladores de miniporte 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 de NDIS_OID_REQUEST que apunta a un BOOLEAN y InformationBufferLength miembro igual a sizeof(booleano).

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

  El controlador de miniport 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, vea Lectura del Registro en un controlador de miniporte NDIS 6.0.

  2. Llame a NdisReadConfiguration, pasando:

     • "*NetworkDirect" para el parámetro palabra clave

     • NdisParameterInteger para el parámetro ParameterType

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

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

Nota Un controlador de miniport compatible con NDK nunca debe llamar a NdisMNetPnPEvent desde el contexto de su función de 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.

Una función de miniporte compatible con NDK MiniportOidRequest 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 admitido	No se admite ninguna
Servidor mínimo admitido	Windows Server 2012
Versión	Compatible con NDIS 6.30 y versiones posteriores.
Encabezado	Ntddndis.h (include Ndis.h)

Consulte también

NDIS_OID_REQUEST

NdisMNetPnPEvent de

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER