Función NdisOpenConfigurationEx (ndis.h)

Artículo
08/07/2023

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 NDIS_CONFIGURATION_OBJECT estructura.

[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	Error de NdisOpenConfigurationEx debido a recursos insuficientes.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx devuelve NDIS_STATUS_FAILURE si no se aplica ninguno de los valores anteriores.

Comentarios

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 siguientes funciones:

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

El tipo de datos del Registro que está asociado al identificador de configuración depende del tipo de identificador que el autor de la llamada pasa a NdisOpenConfigurationEx en el miembro NdisHandle del 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 La 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 minipuerto puede usar el identificador de configuración hasta que llame a . Función NdisMDeregisterMiniportDriver .

Si el controlador obtuvo el identificador en NdisHandle del parámetro MiniportAdapterHandle 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 minipuerto puede pasar el identificador de configuración a la función NdisReadNetworkAddress para recuperar la información de direcciones de red que el software puede configurar y administrar localmente. Los controladores miniport pueden usar el controlador de configuración hasta que NDIS detenga el adaptador de minipuerto y la función MiniportHaltEx devuelva.

Si el controlador obtuvo el identificador en NdisHandle llamando a La 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 parámetro BindParameters 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 La 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 llamen 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 los 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 NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION en el miembro Flags del 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 minipuerto. 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	Value
Cliente mínimo compatible	Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis), NdisOpenConfigurationEx(ndis)