estrutura NDIS_CONFIGURATION_PARAMETER (ndis.h)
A estrutura NDIS_CONFIGURATION_PARAMETER contém os dados e o tipo de uma entrada nomeada no registro.
Sintaxe
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;
Membros
ParameterType
O tipo do parâmetro especificado como um dos valores de enumeração NDIS_PARAMETER_TYPE .
Para chamadas bem-sucedidas para a função NdisReadConfiguration , o
O valor ParameterType corresponde ao valor no parâmetro ParameterType . No entanto, quando o parâmetro ParameterType é NdisParameterHexInteger, o valor de membro ParameterType resultante é NdisParameterInteger.
ParameterData
Uma união que contém o valor da entrada nomeada fornecida. Se ParameterType for um tipo de cadeia de caracteres, esse membro será um tipo NDIS_STRING que descreve uma cadeia de caracteres contada no conjunto de caracteres padrão do sistema. Para drivers do Microsoft Windows 2000 e posteriores, essa cadeia de caracteres contém caracteres Unicode. Ou seja, para o Windows 2000 e posterior, o NDIS define o tipo NDIS_STRING como um tipo de UNICODE_STRING .
Essa união contém os seguintes membros:
ParameterData.IntegerData
Um valor ULONG que é usado quando o membro ParameterType é definido como NdisParameterInteger ou NdisParameterHexInteger.
ParameterData.StringData
Um valor NDIS_STRING usado quando o membro ParameterType é definido como NdisParameterString ou NdisParameterMultiString.
ParameterData.BinaryData
Uma estrutura BINARY_DATA usada quando o membro ParameterType é definido como NdisParameterBinary.
Comentários
Para ler parâmetros no registro, um driver NDIS pode chamar a função NdisReadConfiguration . Se a chamada for bem-sucedida, o NDIS retornará um ponteiro para uma estrutura NDIS_CONFIGURATION_PARAMETER no parâmetro ParameterValue de NdisReadConfiguration.
Para gravar parâmetros no registro, um driver NDIS pode chamar a função NdisWriteConfiguration . Nesse caso, o driver inicializa uma estrutura NDIS_CONFIGURATION_PARAMETER e a passa no parâmetro ParameterValue de NdisWriteConfiguration.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte para drivers NDIS 6.0 e NDIS 5.1 no Windows Vista. Com suporte para drivers NDIS 5.1 no Windows XP. |
| Cabeçalho | ndis.h (inclua Ndis.h) |