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

Vedi anche

ANSI_STRING

MiniportInitializeEx

NDIS_CONFIGURATION_PARAMETER

NdisCloseConfiguration

NdisFreeMemory

NdisFreeString

NdisInitAnsiString

NdisInitUnicodeString

NdisInitializeString

NdisOpenConfigurationEx

NdisReadConfiguration

UNICODE_STRING