Função NdisWriteConfiguration (ndis.h)

Artigo
08/07/2023

A função NdisWriteConfiguration grava um valor fornecido pelo chamador para uma entrada especificada no registro. Essa função deve ser invocada serialmente em relação a si mesma e à função NdisReadConfiguration .

Sintaxe

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

Parâmetros

[out] Status

Um ponteiro para uma variável fornecida pelo chamador na qual essa função retorna o status da chamada como um dos seguintes:

NDIS_STATUS_SUCCESS

O valor fornecido em ParameterValue foi gravado no registro. Se essa for uma nova entrada, o nome em Palavra-chave também foi gravado no registro.

NDIS_STATUS_NOT_SUPPORTED

O ParameterType fornecido é inválido.

NDIS_STATUS_RESOURCES

O NDIS não pôde alocar recursos, geralmente memória suficiente, para transferir as informações solicitadas para o registro.

NDIS_STATUS_FAILURE

As informações solicitadas não puderam ser gravadas.

[in] ConfigurationHandle

O identificador para uma chave do Registro que foi retornada pelo NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex ou Função NdisOpenConfigurationKeyByName .

[in] Keyword

Um ponteiro para um tipo de NDIS_STRING que descreve uma cadeia de caracteres contada fornecida pelo chamador, no conjunto de caracteres padrão do sistema, especificando o nome de uma entrada para a qual gravar o valor. Para drivers do Microsoft Windows 2000 e posteriores, essa cadeia de caracteres contém caracteres Unicode. Ou seja, para o Windows 2000 e posterior, o NDIS define o tipo NDIS_STRING como um tipo de UNICODE_STRING .

[in] ParameterValue

Ponteiro para um chamador fornecido NDIS_CONFIGURATION_PARAMETER estrutura.

Retornar valor

Nenhum

Comentários

Se uma entrada com o mesmo nome que em Palavra-chave já existir sob a chave do Registro aberta, NdisWriteConfiguration substituirá seu valor atual pelo valor fornecido pelo chamador. Caso contrário, NdisWriteConfiguration adicionará uma nova entrada de valor com o nome fornecido e o valor fornecido ao Registro.

No registro de configuração do Windows 2000 e versões posteriores, uma palavra-chave NDIS é um sinônimo de um nome de entrada de valor. Esse nome é uma sequência contada de caracteres Unicode, encerrada com um NUL.

NdisWriteConfiguration buffers e copia a cadeia de caracteres fornecida pelo chamador em Palavra-chave e os dados fornecidos pelo chamador especificados em ParameterValue . Essa memória é liberada quando o driver libera o ConfigurationHandle com a função NdisCloseConfiguration . O chamador de NdisWriteConfiguration é responsável por liberar a cadeia de caracteres armazenada em buffer em Palavra-chave e a memória alocada para o NDIS_CONFIGURATION_PARAMETER estrutura.

Como alternativa à chamada de NdisWriteConfiguration, cada driver NDIS pode configurar informações de configuração no registro para si mesmo usando a diretiva AddReg no arquivo INF do driver.

Para obter mais informações sobre arquivos de instalação e instalação do Windows 2000 e versões posteriores, consulte Visão geral da instalação do dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisWriteConfiguration (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisWriteConfiguration (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	Irql_Miscellaneous_Function(ndis)