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

The NdisWriteConfiguration function writes a caller-supplied value for a specified entry into the registry. This function must be invoked serially with respect to itself and the NdisReadConfiguration function.

Syntax

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

Parameters

[out] Status

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

NDIS_STATUS_SUCCESS

The supplied value at ParameterValue was written into the registry. If this is a new entry, the name at Keyword also was written into the registry.

NDIS_STATUS_NOT_SUPPORTED

The supplied ParameterType is invalid.

NDIS_STATUS_RESOURCES

NDIS не удалось выделить ресурсы, как правило, достаточно памяти для передачи запрошенной информации в реестр.

NDIS_STATUS_FAILURE

Запрошенные сведения не могут быть записаны.

[in] ConfigurationHandle

The handle to a registry key that was returned by the NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex, or NdisOpenConfigurationKeyByName function.

[in] Keyword

Указатель на тип NDIS_STRING, описывающий подсчитываемую строку вызывающего абонента, в системном наборе символов по умолчанию, указав имя записи, для которой необходимо записать значение. Для драйверов Microsoft Windows 2000 и более поздних версий эта строка содержит символы Юникода. That is, for Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.

[in] ParameterValue

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

Return value

None

Remarks

If an entry of the same name as at Keyword already exists under the opened registry key, NdisWriteConfiguration replaces its current value with the caller-supplied value. Otherwise, NdisWriteConfiguration adds a new value entry with the given name and supplied value to the registry.

In the configuration registry of Windows 2000 and later versions, an NDIS Keyword is a synonym for a value entry name. Такое имя — это подсчитываемая последовательность символов Юникода, завершаемая пустым символом.

NdisWriteConfiguration buffers and copies the caller-supplied string at Keyword and the caller-supplied data specified at ParameterValue . This memory is freed when the driver releases the ConfigurationHandle with the NdisCloseConfiguration function. The caller of NdisWriteConfiguration is responsible for releasing the buffered string at Keyword and the memory allocated for the NDIS_CONFIGURATION_PARAMETER structure.

As an alternative to calling NdisWriteConfiguration, every NDIS driver can set up configuration information in the registry for itself using the AddReg directive in the driver's INF file.

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

Requirements

See also

ANSI_STRING

MiniportInitializeEx

NDIS_CONFIGURATION_PARAMETER

NdisCloseConfiguration

NdisFreeMemory

NdisFreeString

NdisInitAnsiString

NdisInitUnicodeString

NdisInitializeString

NdisOpenConfigurationEx

NdisReadConfiguration

UNICODE_STRING