Funzione NdisReadConfiguration (ndis.h)

Articolo
08/07/2023

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.

Valore	Significato
NDIS_STATUS_SUCCESS	Il buffer in ParameterValue contiene le informazioni di configurazione restituite.
NDIS_STATUS_RESOURCES	Non è stato possibile allocare risorse, in genere memoria sufficiente, per restituire le informazioni richieste.
NDIS_STATUS_FAILURE	Impossibile trovare le informazioni richieste nella chiave del Registro di sistema aperta designata da ConfigurationHandle.

[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	NdisProcessorX86 NdisProcessorAmd64 NdisProcessorIA64 NdisProcessorAlpha Di seguito è possibile solo se un driver precedente (pre-NDIS 6.0) è possibile: NdisProcessorMips NdisProcessorPpc
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.

Nome voce predefinito

Valori restituiti predefiniti

ProcessorType

NdisProcessorX86
NdisProcessorAmd64
NdisProcessorIA64
NdisProcessorAlpha

Di seguito è possibile solo se un driver precedente (pre-NDIS 6.0) è possibile:

NdisProcessorMips
NdisProcessorPpc

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)