Поделиться через


структура NDIS_CONFIGURATION_PARAMETER (ndis.h)

Структура NDIS_CONFIGURATION_PARAMETER содержит данные и тип именованной записи в реестре.

Синтаксис

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;

Члены

ParameterType

Тип параметра, указанного в качестве одного из значений перечисления NDIS_PARAMETER_TYPE .

Для успешных вызовов функции NdisReadConfiguration
Значение ParameterType соответствует значению параметра ParameterType . Однако если параметр ParameterType имеет значение NdisParameterHexInteger, результирующее значение члена ParameterTypeNdisParameterInteger.

ParameterData

Объединение, содержащее значение указанной именованной записи. Если ParameterType является строковым типом, этот член является NDIS_STRING типом, описывающим подсчитываемую строку в системном наборе символов по умолчанию. Для драйверов Microsoft Windows 2000 и более поздних версий такая строка содержит символы Юникода. То есть для Windows 2000 и более поздних версий NDIS определяет тип NDIS_STRING как тип UNICODE_STRING .

Это объединение содержит следующие члены:

ParameterData.IntegerData

Значение ULONG, используемое, если член ParameterType имеет значение NdisParameterInteger или NdisParameterHexInteger.

ParameterData.StringData

Значение NDIS_STRING, используемое, если для элемента ParameterType задано значение NdisParameterString или NdisParameterMultiString.

ParameterData.BinaryData

Структура BINARY_DATA , которая используется, когда члену ParameterType присвоено значение NdisParameterBinary.

Комментарии

Для чтения параметров в реестре драйвер NDIS может вызвать функцию NdisReadConfiguration . Если вызов выполнен успешно, NDIS возвращает указатель на структуру NDIS_CONFIGURATION_PARAMETER с параметром ParameterValueобъекта NdisReadConfiguration.

Для записи параметров в реестр драйвер NDIS может вызвать функцию NdisWriteConfiguration . В этом случае драйвер инициализирует структуру NDIS_CONFIGURATION_PARAMETER и передает ее по параметру ParameterValueобъекта NdisWriteConfiguration.

Требования

Требование Значение
Минимальная версия клиента Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 в Windows Vista. Поддерживается для драйверов NDIS 5.1 в Windows XP.
Верхняя часть ndis.h (включая Ndis.h)

См. также раздел

BINARY_DATA

NDIS_PARAMETER_TYPE

NdisReadConfiguration

NdisWriteConfiguration

UNICODE_STRING