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)

Confira também

BINARY_DATA

NDIS_PARAMETER_TYPE

NdisReadConfiguration

NdisWriteConfiguration

UNICODE_STRING