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

Vedi anche

BINARY_DATA

NDIS_PARAMETER_TYPE

NdisReadConfiguration

NdisWriteConfiguration

UNICODE_STRING