Funzione NdisWriteConfiguration (ndis.h)

Articolo
02/26/2024

La funzione NdisWriteConfiguration scrive un valore fornito dal chiamante per una voce specificata nel Registro di sistema. Questa funzione deve essere richiamata in modo seriale 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 fornito in ParameterValue è stato scritto nel Registro di sistema. Se si tratta di una nuova voce, anche il nome in Keyword è stato scritto nel Registro di sistema.

NDIS_STATUS_NOT_SUPPORTED

ParameterType specificato non è valido.

NDIS_STATUS_RESOURCES

NDIS non è riuscito ad allocare risorse, in genere memoria sufficiente, per trasferire le informazioni richieste al Registro di sistema.

NDIS_STATUS_FAILURE

Impossibile scrivere le informazioni richieste.

[in] ConfigurationHandle

Handle di 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 con conteggio fornita dal chiamante, nel set di caratteri predefinito del sistema, specificando il nome di una voce per cui scrivere il valore. Per i driver di 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 di 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 keyword 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, una parola chiave NDIS è un sinonimo di un nome di voce valore. Tale nome è una sequenza con conteggiata di caratteri Unicode, terminata con un valore NUL.

NdisWriteConfiguration buffers e copia la stringa fornita dal chiamante in Keyword 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 Keyword e della memoria allocata per NDIS_CONFIGURATION_PARAMETER struttura.

In alternativa alla chiamata a 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 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 (include Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Miscellaneous_Function(ndis)