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;
Membri
ParameterType
Tipo del parametro specificato come uno dei valori di enumerazione NDIS_PARAMETER_TYPE.
Per le chiamate riuscite alla funzione di NdisReadConfiguration,
parametroType valore corrisponde al valore del parametro ParameterType. Tuttavia, quando il parametro ParameterType è NdisParameterHexInteger, il valore ParameterType risultante membro è 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 UNICODE_STRING.
Questa unione contiene i membri seguenti:
ParameterData.IntegerData
Valore ULONG utilizzato quando il membro ParameterType viene impostato su NdisParameterInteger o NdisParameterHexInteger.
ParameterData.StringData
Valore NDIS_STRING utilizzato quando il membro ParameterType viene impostato su NdisParameterString o NdisParameterMultiString.
ParameterData.BinaryData
Struttura BINARY_DATA utilizzata quando il membro ParameterType è impostato su NdisParameterBinary.
Osservazioni
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.
Fabbisogno
| 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) |