Função NdisWriteConfiguration (ndis.h)
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 caractere nulo.
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) |