Función NdisWriteConfiguration (ndis.h)
La función NdisWriteConfiguration escribe un valor proporcionado por el autor de la llamada para una entrada especificada en el Registro. Esta función se debe invocar en serie con respecto a sí misma y a la función NdisReadConfiguration .
Sintaxis
void NdisWriteConfiguration(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] PNDIS_CONFIGURATION_PARAMETER ParameterValue
);
Parámetros
[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 siguientes:
NDIS_STATUS_SUCCESS
El valor proporcionado en ParameterValue se escribió en el Registro. Si se trata de una nueva entrada, el nombre de Keyword también se escribió en el Registro.
NDIS_STATUS_NOT_SUPPORTED
ParameterType proporcionado no es válido.
NDIS_STATUS_RESOURCES
NDIS no pudo asignar recursos, normalmente suficiente memoria, para transferir la información solicitada al Registro.
NDIS_STATUS_FAILURE
No se pudo escribir la información solicitada.
[in] ConfigurationHandle
Identificador de una clave del Registro devuelta por NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex o Función NdisOpenConfigurationKeyByName .
[in] Keyword
Puntero a un tipo NDIS_STRING que describe una cadena con recuento proporcionada por el autor de la llamada, en el juego de caracteres predeterminado del sistema, especificando el nombre de una entrada para la que se va a escribir el valor. Para los controladores de Microsoft Windows 2000 y versiones posteriores, esta cadena contiene caracteres Unicode. Es decir, para Windows 2000 y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .
[in] ParameterValue
Puntero a un autor de llamada proporcionado NDIS_CONFIGURATION_PARAMETER estructura.
Valor devuelto
None
Observaciones
Si ya existe una entrada del mismo nombre que en Keyword en la clave del Registro abierta, NdisWriteConfiguration reemplaza su valor actual por el valor proporcionado por el autor de la llamada. De lo contrario, NdisWriteConfiguration agrega una nueva entrada de valor con el nombre especificado y el valor proporcionado al Registro.
En el registro de configuración de Windows 2000 y versiones posteriores, una palabra clave NDIS es un sinónimo de un nombre de entrada de valor. Este nombre es una secuencia contada de caracteres Unicode, terminada con un carácter NULL.
NdisWriteConfiguration almacena en búferes y copia la cadena proporcionada por el autor de la llamada en Keyword y los datos proporcionados por el autor de la llamada especificados en ParameterValue . Esta memoria se libera cuando el controlador libera ConfigurationHandle con la función NdisCloseConfiguration . El autor de la llamada de NdisWriteConfiguration es responsable de liberar la cadena almacenada en búfer en Palabra clave y la memoria asignada para el NDIS_CONFIGURATION_PARAMETER estructura.
Como alternativa a llamar a NdisWriteConfiguration, cada controlador NDIS puede configurar información de configuración en el registro para sí misma mediante la directiva AddReg en el archivo INF del controlador.
Para obtener más información sobre los archivos de instalación e instalación de Windows 2000 y versiones posteriores, vea Información general sobre la instalación de dispositivos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisWriteConfiguration (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisWriteConfiguration (NDIS 5.1)) en Windows XP. |
| 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) |