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 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 Palabra clave también se escribió en el registro.
NDIS_STATUS_NOT_SUPPORTED
El 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 el NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex, o función NdisOpenConfigurationKeyByName.
[in] Keyword
Puntero a un tipo de NDIS_STRING que describe una cadena con recuento proporcionada por el autor de la llamada, en el conjunto 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 estructura NDIS_CONFIGURATION_PARAMETER.
Valor devuelto
Ninguno
Observaciones
Si ya existe una entrada del mismo nombre que en Palabra clave existe 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, un de 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 el configurationHandle de 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 estructura NDIS_CONFIGURATION_PARAMETER.
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 la instalación y los archivos de instalación de Windows 2000 y versiones posteriores, consulte Información general sobre la instalación de dispositivos.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con los 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. |
| 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) |