Функция NdisWriteConfiguration (ndis.h)
Функция 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 было записано в реестр. Если это новая запись, имя Keyword также было записано в реестр.
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 структура.
Возвращаемое значение
Никакой
Замечания
Если запись того же имени, что и в Ключевое слово уже существует в открытом разделе реестра, NdisWriteConfiguration заменяет текущее значение вызывающим значением. В противном случае NdisWriteConfiguration добавляет новую запись значения с заданным именем и предоставленным значением в реестр.
В реестре конфигурации Windows 2000 и более поздних версий ключевое слово NDIS является синонимом имени записи значений. Такое имя — это подсчитываемая последовательность символов Юникода, завершаемая пустым символом.
буферы NdisWriteConfiguration и копирует строку, предоставленную вызывающим объектом, ключевого слова и предоставленные вызывающим объектом данные, указанные в ParameterValue. Эта память освобождается, когда драйвер освобождает ConfigurationHandle с функцией NdisCloseConfiguration. Вызывающий объект NdisWriteConfiguration отвечает за освобождение буферизованной строки в ключевого слова и памяти, выделенной для буферизованной строки. NDIS_CONFIGURATION_PARAMETER структура.
В качестве альтернативы вызову NdisWriteConfiguration каждый драйвер NDIS может настроить сведения о конфигурации в реестре для себя с помощью директивы AddReg в INF-файле драйвера.
Дополнительные сведения о файлах установки и установки для Windows 2000 и более поздних версий см. в обзоре установки устройств.