Función NdisReadConfiguration (ndis.h)

The NdisReadConfiguration function returns the value of a named entry of the specified type from the registry, given the handle to an open registry key. This function must be invoked serially with respect to itself and the NdisWriteConfiguration function.

Syntax

VOID NdisReadConfiguration(
  [out] PNDIS_STATUS                  Status,
  [out] PNDIS_CONFIGURATION_PARAMETER *ParameterValue,
  [in]  NDIS_HANDLE                   ConfigurationHandle,
  [in]  PNDIS_STRING                  Keyword,
  [in]  NDIS_PARAMETER_TYPE           ParameterType
);

Parameters

[out] Status

Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve el estado de la llamada como uno de los valores siguientes.

Value	Meaning
NDIS_STATUS_SUCCESS	The buffer at ParameterValue contains the returned configuration information.
NDIS_STATUS_RESOURCES	NDIS no pudo asignar recursos, normalmente suficiente memoria, para devolver la información solicitada.
NDIS_STATUS_FAILURE	The requested information could not be found under the opened registry key designated by the ConfigurationHandle.

[out] ParameterValue

Puntero a una ubicación de memoria donde NDIS proporciona un puntero a un NDIS_CONFIGURATION_PARAMETER structure if the call to NdisReadConfiguration is successful. NDIS asigna memoria para NDIS_CONFIGURATION_PARAMETER structure.

[in] ConfigurationHandle

The handle to a registry key that was returned by the NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex, or NdisOpenConfigurationKeyByName function.

[in] Keyword

Puntero a un tipo de NDIS_STRING proporcionado por el autor de la llamada que describe una cadena con recuento, en el juego de caracteres predeterminado del sistema, especificando el nombre de la entrada en la clave del Registro abierta para la que se va a devolver el valor.

Como alternativa, puntero a un NDIS_STRING_CONSTANT proporcionado por el autor de la llamada especificando uno de los siguientes nombres de entrada predefinidos junto con valores devueltos predefinidos:

Nombre de entrada predefinido	Valores devueltos predefinidos
ProcessorType	NdisProcessorX86 NdisProcessorAmd64 NdisProcessorIA64 NdisProcessorAlpha Los siguientes son posibles solo si un controlador anterior (anterior a NDIS 6.0): NdisProcessorMips NdisProcessorPpc
NdisVersion	0xMMMMmmmm, where MMMM is the major version and mmmm is the minor version number. Por ejemplo, 0x00050000 indica que la versión NDIS más alta admitida por el sistema es la versión principal 5, versión secundaria 0.

Nombre de entrada predefinido

Valores devueltos predefinidos

ProcessorType

NdisProcessorX86
NdisProcessorAmd64
NdisProcessorIA64
NdisProcessorAlpha

Los siguientes son posibles solo si un controlador anterior (anterior a NDIS 6.0):

NdisProcessorMips
NdisProcessorPpc

NdisVersion

0xMMMMmmmm, where MMMM is the major version and mmmm is the minor version number. Por ejemplo, 0x00050000 indica que la versión NDIS más alta admitida por el sistema es la versión principal 5, versión secundaria 0.

[in] ParameterType

The type of the value entry that is specified as one of the NDIS_PARAMETER_TYPE enumeration values. Este parámetro se omite en Windows NT y versiones posteriores.

Return value

None

Remarks

In the configuration registry of Windows 2000 and later versions, an NDIS keyword is a synonym for a value entry name. Such a name is a counted sequence of Unicode characters, terminated with a NULL.

Every NDIS driver can set up configuration information in the registry for itself using the AddReg directive in its INF file. Por ejemplo, un controlador de protocolo puede almacenar su propio nombre como una entrada con un valor de cadena con formato previo que se puede pasar a las llamadas a . NdisRegisterProtocolDriver function. Para obtener más información, vea Add-registry-sections in a Network INF File.

Cada controlador de miniport también tiene entradas de valor asociadas en el Registro. Las entradas de valor de cualquier controlador de miniport particular pueden depender del dispositivo por naturaleza. Por ejemplo, un controlador de minipuerto podría tener palabras clave como *FlowControl, *SpeedDuplex y *InterruptModeration. El valor asociado a dicha palabra clave NDIS puede ser un entero (tipo ULONG) o una cadena (NDIS_STRING-type). For example, the set of possible values for the already mentioned *FlowControl entry might be NdisParameterInteger values 0, 1, 2, or 3, or the equivalents in hexadecimal as NdisParameterHexInteger values.

NdisReadConfiguration buffers and copies the caller-supplied string at Keyword and releases the storage it allocates for this copy before it returns control to the caller. Memoria que asigna para NDIS_CONFIGURATION_PARAMETER structure is freed when the driver releases the ConfigurationHandle with the NdisCloseConfiguration function. The caller of NdisReadConfiguration is responsible for releasing the buffered string at Keyword.

Tenga en cuenta que NDIS no valida los valores que lee un controlador del Registro. The caller of NdisReadConfiguration must therefore not make any assumptions about such values and must validate each value read from the registry. Si el autor de la llamada determina que un valor está fuera de los límites, debe usar un valor predeterminado en su lugar.

Para obtener más información sobre los archivos de instalación e instalación, consulte Información general sobre la instalación de dispositivos.

Requirements

Requirement	Value
cliente mínimo admitido	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisReadConfiguration (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisReadConfiguration (NDIS 5.1)) en Windows XP.
Target Platform	Universal
Header	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis)

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-07-23