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 una delle seguenti:
NDIS_STATUS_SUCCESS
Il valore specificato in ParameterValue è stato scritto nel Registro di sistema. Se si tratta di una nuova voce, il nome in Parola chiave è stato scritto anche nel Registro di sistema.
NDIS_STATUS_NOT_SUPPORTED
ParametroType specificato non è valido.
NDIS_STATUS_RESOURCES
Non è stato possibile 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 a una chiave del Registro di sistema restituita da NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex o Funzione NdisOpenConfigurationKeyByName .
[in] Keyword
Puntatore a un tipo NDIS_STRING che descrive una stringa 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. Vale a dire, per Windows 2000 e versioni successive, NDIS definisce il tipo NDIS_STRING come tipo di UNICODE_STRING .
[in] ParameterValue
Puntatore a un chiamante fornito NDIS_CONFIGURATION_PARAMETER struttura.
Valore restituito
nessuno
Osservazioni
Se esiste già una voce dello stesso nome della 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 specificato valore al Registro di sistema.
Nel Registro di configurazione di Windows 2000 e versioni successive, una parola chiave NDIS è un sinonimo di un nome di voce valore. Tale nome è una sequenza conteggiata di caratteri Unicode, terminata con un carattere Null.
Buffer NdisWriteConfiguration e copia la stringa fornita dal chiamante in Parola chiave e i dati forniti dal chiamante specificati in ParameterValue . Questa memoria viene liberata quando il driver rilascia 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 l'oggetto NDIS_CONFIGURATION_PARAMETER struttura.
In alternativa alla chiamata a NdisWriteConfiguration, ogni driver NDIS può configurare le informazioni di configurazione nel Registro di sistema usando la direttiva AddReg nel file INF del driver.
Per altre informazioni sull'installazione e sui file di installazione per Windows 2000 e versioni successive, vedere Panoramica dell'installazione del dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisWriteConfiguration (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisWriteConfiguration (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Universale |
| Intestazione | ndis.h (includere Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | Irql_Miscellaneous_Function(ndis) |