Funzione NdisWriteConfiguration (ndis.h)
La funzione NdisWriteConfiguration scrive un valore fornito dal chiamante per una voce specificata nel Registro di sistema. Questa funzione deve essere richiamata serialmente rispetto a se stessa e alla funzione NdisReadConfiguration.
Sintassi
void NdisWriteConfiguration(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] PNDIS_CONFIGURATION_PARAMETER ParameterValue
);
Parametri
[out] Status
Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce lo stato della chiamata come uno dei seguenti:
NDIS_STATUS_SUCCESS
Il valore fornito in ParameterValue è stato scritto nel Registro di sistema. Se si tratta di una nuova voce, anche il nome in Parola chiave è stato scritto nel Registro di sistema.
NDIS_STATUS_NOT_SUPPORTED
La ParameterType specificata non è valida.
NDIS_STATUS_RESOURCES
NDIS non è riuscito ad allocare risorse, in genere memoria sufficiente, per trasferire le informazioni richieste nel Registro di sistema.
NDIS_STATUS_FAILURE
Impossibile scrivere le informazioni richieste.
[in] ConfigurationHandle
Handle di una chiave del Registro di sistema restituita dal NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndexo funzione NdisOpenConfigurationKeyByName.
[in] Keyword
Puntatore a un tipo NDIS_STRING che descrive una stringa con conteggiata fornita dal chiamante, nel set di caratteri predefinito del sistema, specificando il nome di una voce per cui scrivere il valore. Per i driver Microsoft Windows 2000 e versioni successive, questa stringa contiene caratteri Unicode. Ovvero, per Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo UNICODE_STRING.
[in] ParameterValue
Puntatore a un chiamante fornito NDIS_CONFIGURATION_PARAMETER struttura.
Valore restituito
Nessuno
Osservazioni
Se esiste già una voce con lo stesso nome di Parola chiave nella chiave del Registro di sistema aperta, NdisWriteConfiguration sostituisce il valore corrente con il valore fornito dal chiamante. In caso contrario, NdisWriteConfiguration aggiunge una nuova voce di valore con il nome specificato e il valore fornito al Registro di sistema.
Nel Registro di sistema di configurazione di Windows 2000 e versioni successive, un parola chiave NDIS è un sinonimo di una voce di valore . Un nome di questo tipo è una sequenza con conteggiata di caratteri Unicode, terminata con un carattere Null.
buffer di NdisWriteConfiguration e copia la stringa fornita dal chiamante in Keyword e i dati specificati dal chiamante in ParameterValue . Questa memoria viene liberata quando il driver rilascia il ConfigurationHandle con la funzione NdisCloseConfiguration. Il chiamante di NdisWriteConfiguration è responsabile del rilascio della stringa memorizzata nel buffer in Parola chiave e della memoria allocata per il NDIS_CONFIGURATION_PARAMETER struttura.
In alternativa alla chiamata di NdisWriteConfiguration, ogni driver NDIS può configurare le informazioni di configurazione nel Registro di sistema per se stesso usando la direttiva AddReg nel file INF del driver.
Per altre informazioni sui file di installazione e installazione per Windows 2000 e versioni successive, vedere panoramica dell'installazione dei dispositivi .