Функция 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 было записано в реестр. Если это новая запись, имя ключевого слова также было записано в реестр.
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 является синонимом имени записи значения. Такое имя представляет собой отсчетную последовательность символов Юникода, заканчиваемую символом NULL.
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) |