Función NdisOpenConfigurationEx (ndis.h)

Artículo
02/07/2025

Los controladores NDIS llaman a la función NdisOpenConfigurationEx para obtener un identificador de configuración que permita el acceso a los parámetros de configuración del Registro.

Sintaxis

NDIS_STATUS NdisOpenConfigurationEx(
  [in]  PNDIS_CONFIGURATION_OBJECT ConfigObject,
  [out] PNDIS_HANDLE               ConfigurationHandle
);

Parámetros

[in] ConfigObject

Puntero a un autor de llamada proporcionado e inicializado estructura NDIS_CONFIGURATION_OBJECT.

[out] ConfigurationHandle

Puntero a una variable proporcionada por el autor de la llamada en la que NdisOpenConfigurationEx devuelve un identificador a una clave del Registro. La clave del Registro identifica los parámetros de configuración.

Valor devuelto

NdisOpenConfigurationEx devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NdisOpenConfigurationEx abrió correctamente la clave del Registro donde se almacenan los parámetros de configuración del controlador.
NDIS_STATUS_RESOURCES	NdisOpenConfigurationEx no se pudo realizar debido a recursos insuficientes.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx devuelve NDIS_STATUS_FAILURE si no se aplica ninguno de los valores anteriores.

Observaciones

NdisOpenConfigurationEx devuelve un identificador de configuración en el parámetro ConfigurationHandle. El identificador de configuración está asociado a una clave del Registro que identifica la ubicación de los parámetros de configuración. El autor de la llamada puede pasar el identificador de configuración a otras funciones de configuración de NDIS para leer o escribir información en el Registro.

Para acceder a la información de configuración, use el identificador de configuración con las funciones siguientes:

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

El tipo de datos del Registro que está asociado al controlador de configuración depende del tipo de identificador que el autor de la llamada pasa a NdisOpenConfigurationEx en el miembro de NdisHandle del miembro de la clase NDIS_CONFIGURATION_OBJECT estructura a la que hace referencia el parámetro ConfigObject. El identificador puede identificar parámetros asociados al controlador o a una instancia del controlador.

Si el controlador obtuvo el identificador en NdisHandle llamando a función NdisMRegisterMiniportDriver, NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración del controlador de miniport. El controlador de miniport puede usar el identificador de configuración hasta que llame a . función NdisMDeregisterMiniportDriver.

Si el controlador obtuvo el identificador en NdisHandle de la MiniportAdapterHandle parámetro de la función MiniportInitializeEx, NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración de un adaptador de miniporte. Un controlador de miniport puede pasar el identificador de configuración al función NdisReadNetworkAddress para recuperar la información de dirección de red que el software puede configurar y administrar localmente. Los controladores de miniport pueden usar el controlador de configuración hasta que NDIS detenga el adaptador de miniporte y la función miniportal MiniportHaltEx.

Si el controlador obtuvo el identificador en NdisHandle llamando a función NdisRegisterProtocolDriver, NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración del controlador de protocolo. El controlador de protocolo puede usar el identificador de configuración hasta que llame a . función NdisDeregisterProtocolDriver.

Si el identificador de NdisHandle es un puntero a una estructura de NDIS_BIND_PARAMETERS que NDIS pasó en el BindParameters parámetro de la función ProtocolBindAdapterEx, NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración de un enlace de protocolo. Los controladores de protocolo pueden usar el identificador de configuración hasta que se complete la operación de enlace.

Si el controlador obtuvo el identificador en NdisHandle llamando a la función NdisOpenAdapterEx, NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración de un enlace de protocolo. El controlador de protocolo puede usar el identificador de configuración hasta que llame a la función NdisCloseAdapterEx.

Si un controlador de filtro obtuvo el identificador en NdisHandle llamando a función NdisFRegisterFilterDriver, NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración del controlador de filtro. Los controladores de filtro pueden usar el identificador de configuración hasta que llaman a función NdisFDeregisterFilterDriver.

Si un controlador de filtro obtuvo el identificador en NdisHandle del parámetro NdisFilterHandle de la función FilterAttach, NdisOpenConfigurationEx proporciona un identificador a la ubicación del Registro donde se almacenan los parámetros de configuración de módulos de filtro. El controlador de filtro puede usar el identificador de configuración hasta que NDIS desasocie el módulo de filtro y la función FilterDetach devuelva. Si un controlador de filtro de supervisión especifica la marca de NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION en el Flags miembro del elemento NDIS_CONFIGURATION_OBJECT estructura, el controlador puede acceder a la configuración del módulo de filtro para un módulo de filtro específico cuando hay varios módulos de filtro configurados en el mismo adaptador de miniport. La modificación de controladores de filtro no debe usar esta marca.

Una vez que un controlador haya terminado de acceder a la información de configuración, el controlador debe llamar a la función NdisCloseConfiguration para liberar el identificador de configuración y los recursos relacionados.

Nota Para asegurarse de que esta función se ejecuta en IRQL = PASSIVE_LEVEL, un controlador puede programar un elemento de trabajo NDIS y llamar a esta y otras funciones de configuración en el contexto de la devolución de llamada del elemento de trabajo.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis), NdisOpenConfigurationEx(ndis)