Функция NdisWriteConfiguration (ndis.h)

Статья
02/26/2024

Функция NdisWriteConfiguration записывает предоставленное вызывающим объектом значение для указанной записи в реестр. Эта функция должна вызываться последовательно относительно самой себя и функции NdisReadConfiguration .

Синтаксис

void NdisWriteConfiguration(
  [out] PNDIS_STATUS                  Status,
  [in]  NDIS_HANDLE                   ConfigurationHandle,
  [in]  PNDIS_STRING                  Keyword,
  [in]  PNDIS_CONFIGURATION_PARAMETER ParameterValue
);

Параметры

[out] Status

Указатель на переменную, предоставленную вызывающей стороны, в которой эта функция возвращает состояние вызова в виде одного из следующих:

NDIS_STATUS_SUCCESS

Указанное значение ParameterValue было записано в реестр. Если это новая запись, в реестр также было записано имя ключевого слова .

NDIS_STATUS_NOT_SUPPORTED

Указанный параметр ParameterType недопустим.

NDIS_STATUS_RESOURCES

NDIS не удалось выделить ресурсы( обычно достаточно памяти) для передачи запрошенных сведений в реестр.

NDIS_STATUS_FAILURE

Не удалось записать запрошенную информацию.

[in] ConfigurationHandle

Дескриптор раздела реестра, возвращенного NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex или Функция NdisOpenConfigurationKeyByName .

[in] Keyword

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

[in] ParameterValue

Указатель на предоставленный вызывающим NDIS_CONFIGURATION_PARAMETER структура.

Возвращаемое значение

None

Remarks

Если запись с тем же именем, что и в ключевом слове , уже существует в открытом разделе реестра, NdisWriteConfiguration заменяет свое текущее значение указанным вызывающим значением. В противном случае NdisWriteConfiguration добавляет в реестр новую запись значения с заданным именем и предоставленным значением.

В реестре конфигурации Windows 2000 и более поздних версий ключевое слово NDIS является синонимом имени записи значения. Такое имя — это подсчитываемая последовательность символов Юникода, оканчиваемая символом NUL.

NdisWriteConfiguration буферизует и копирует строку, предоставленную вызывающим объектом, в ключевом слове , и данные, предоставленные вызывающим объектом, указанные в параметре ParameterValue . Эта память освобождается, когда драйвер выпускает ConfigurationHandle с функцией NdisCloseConfiguration . Вызывающий объект NdisWriteConfiguration отвечает за освобождение буферизованной строки в ключевом слове и памяти, выделенной для NDIS_CONFIGURATION_PARAMETER структура.

В качестве альтернативы вызову NdisWriteConfiguration каждый драйвер NDIS может настроить сведения о конфигурации в реестре для себя с помощью директивы AddReg в INF-файле драйвера.

Дополнительные сведения о файлах установки и установки для Windows 2000 и более поздних версий см. в статье Общие сведения об установке устройств.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisWriteConfiguration (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisWriteConfiguration (NDIS 5.1)) в Windows XP.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	Irql_Miscellaneous_Function(ndis)