struttura NDIS_CONFIGURATION_PARAMETER (ndis.h)
La struttura NDIS_CONFIGURATION_PARAMETER contiene i dati e il tipo di una voce denominata nel Registro di sistema.
Sintassi
typedef struct _NDIS_CONFIGURATION_PARAMETER {
NDIS_PARAMETER_TYPE ParameterType;
union {
ULONG IntegerData;
NDIS_STRING StringData;
BINARY_DATA BinaryData;
} ParameterData;
} NDIS_CONFIGURATION_PARAMETER, *PNDIS_CONFIGURATION_PARAMETER;
Members
ParameterType
Tipo del parametro specificato come uno dei valori di enumerazione NDIS_PARAMETER_TYPE .
Per le chiamate riuscite alla funzione NdisReadConfiguration ,
Il valore ParameterType corrisponde al valore del parametro ParameterType . Tuttavia, quando il parametro ParameterType è NdisParameterHexInteger, il valore del membro ParameterType risultante è NdisParameterInteger.
ParameterData
Unione che contiene il valore della voce denominata specificata. Se ParameterType è un tipo stringa, questo membro è un tipo NDIS_STRING che descrive una stringa con conteggiata nel set di caratteri predefinito del sistema. Per i driver di Microsoft Windows 2000 e versioni successive, tale stringa contiene caratteri Unicode. Ovvero, per Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo di UNICODE_STRING .
Questa unione contiene i membri seguenti:
ParameterData.IntegerData
Valore ULONG utilizzato quando il membro ParameterType è impostato su NdisParameterInteger o NdisParameterHexInteger.
ParameterData.StringData
Valore NDIS_STRING utilizzato quando il membro ParameterType è impostato su NdisParameterString o NdisParameterMultiString.
ParameterData.BinaryData
Struttura BINARY_DATA utilizzata quando il membro ParameterType è impostato su NdisParameterBinary.
Commenti
Per leggere i parametri nel Registro di sistema, un driver NDIS può chiamare la funzione NdisReadConfiguration . Se la chiamata ha esito positivo, NDIS restituisce un puntatore a una struttura NDIS_CONFIGURATION_PARAMETER nel parametro ParameterValue di NdisReadConfiguration.
Per scrivere parametri nel Registro di sistema, un driver NDIS può chiamare la funzione NdisWriteConfiguration . In questo caso, il driver inizializza una struttura NDIS_CONFIGURATION_PARAMETER e la passa al parametro ParameterValue di NdisWriteConfiguration.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 in Windows Vista. Supportato per i driver NDIS 5.1 in Windows XP. |
| Intestazione | ndis.h (include Ndis.h) |