Funzione NdisReadConfiguration (ndis.h)
La funzione NdisReadConfiguration restituisce il valore di una voce denominata del tipo specificato dal Registro di sistema, dato l'handle a una chiave del Registro di sistema aperta. Questa funzione deve essere richiamata serialmente rispetto a se stessa e alla funzione NdisWriteConfiguration .
Sintassi
void NdisReadConfiguration(
[out] PNDIS_STATUS Status,
[out] PNDIS_CONFIGURATION_PARAMETER *ParameterValue,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING Keyword,
[in] NDIS_PARAMETER_TYPE ParameterType
);
Parametri
[out] Status
Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce lo stato della chiamata come uno dei valori seguenti.
[out] ParameterValue
Puntatore a una posizione di memoria in cui NDIS fornisce un puntatore a un oggetto NDIS_CONFIGURATION_PARAMETER struttura se la chiamata a NdisReadConfiguration ha esito positivo. NDIS alloca memoria per l'oggetto NDIS_CONFIGURATION_PARAMETER struttura.
[in] ConfigurationHandle
Handle a una chiave del Registro di sistema restituita da NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex o Funzione NdisOpenConfigurationKeyByName .
[in] Keyword
Puntatore a un chiamante fornito NDIS_STRING tipo che descrive una stringa conteggiata, nel set di caratteri predefinito del sistema, specificando il nome della voce nella chiave del Registro di sistema aperta per cui restituire il valore.
In alternativa, puntatore a un chiamante fornito NDIS_STRING_CONSTANT specificando uno dei nomi di voce predefiniti seguenti insieme ai valori restituiti predefiniti predefiniti:
| Nome voce predefinito | Valori restituiti predefiniti |
|---|---|
| ProcessorType |
|
| NdisVersion | 0xMMMMmmmm, dove MMMM è la versione principale e mmmm è il numero di versione secondaria. Ad esempio, 0x00050000 indica che la versione NDIS più alta supportata dal sistema è la versione principale 5, la versione secondaria 0. |
[in] ParameterType
Tipo della voce valore specificata come uno dei valori di enumerazione NDIS_PARAMETER_TYPE . Questo parametro viene ignorato in Windows NT e versioni successive.
Valore restituito
nessuno
Osservazioni
Nel Registro di sistema di configurazione di Windows 2000 e versioni successive, una parola chiave NDIS è un sinonimo di un nome voce valore. Tale nome è una sequenza conteggiata di caratteri Unicode, terminata con un valore NULL.
Ogni driver NDIS può configurare le informazioni di configurazione nel Registro di sistema usando la direttiva AddReg nel file INF. Ad esempio, un driver del protocollo potrebbe archiviare il proprio nome come voce con un valore stringa preformatato che può essere passato nelle chiamate all'oggetto Funzione NdisRegisterProtocolDriver . Per altre informazioni, vedere Componenti aggiuntivi del Registro di sistema in un file INF di rete.
Ogni driver miniport include anche voci di valore associate nel Registro di sistema. Le voci di valore per qualsiasi particolare driver miniport possono essere dipendenti dal dispositivo in natura. Ad esempio, un driver miniport potrebbe avere parole chiave come *FlowControl, *SpeedDuplex e *InterruptModeration. Il valore associato a tale parola chiave NDIS può essere un intero (tipo ULONG) o una stringa (NDIS_STRING-type). Ad esempio, il set di valori possibili per la voce *FlowControl già menzionato potrebbe essere NdisParameterInteger valori 0, 1, 2 o 3 o gli equivalenti in valori esadecimali come NdisParameterHexInteger .
Buffer NdisReadConfiguration e copia la stringa fornita dal chiamante in Parola chiave e rilascia l'archiviazione allocata per questa copia prima di restituire il controllo al chiamante. Memoria allocata per l'oggetto NDIS_CONFIGURATION_PARAMETER struttura viene liberata quando il driver rilascia ConfigurationHandle con la funzione NdisCloseConfiguration . Il chiamante di NdisReadConfiguration è responsabile del rilascio della stringa memorizzata nel buffer in Parola chiave.
Si noti che NDIS non convalida i valori letti da un driver dal Registro di sistema. Il chiamante di NdisReadConfiguration non deve pertanto fare ipotesi su tali valori e deve convalidare ogni valore letto dal Registro di sistema. Se il chiamante determina che un valore non è limitato, deve usare invece un valore predefinito.
Per altre informazioni sull'installazione e sui file di installazione, vedere Panoramica dell'installazione del dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisReadConfiguration (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisReadConfiguration (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) |