Função NdisOpenConfigurationEx (ndis.h)

Artigo
02/07/2025

Os drivers NDIS chamam a função NdisOpenConfigurationEx para obter um identificador de configuração que permita o acesso aos parâmetros de configuração no Registro.

Sintaxe

NDIS_STATUS NdisOpenConfigurationEx(
  [in]  PNDIS_CONFIGURATION_OBJECT ConfigObject,
  [out] PNDIS_HANDLE               ConfigurationHandle
);

Parâmetros

[in] ConfigObject

Um ponteiro para um chamador fornecido e inicializado NDIS_CONFIGURATION_OBJECT estrutura.

[out] ConfigurationHandle

Um ponteiro para uma variável fornecida pelo chamador na qual NdisOpenConfigurationEx retorna um identificador para uma chave do Registro. A chave do Registro identifica os parâmetros de configuração.

Valor de retorno

NdisOpenConfigurationEx retorna um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	NdisOpenConfigurationEx abriu com êxito a chave do Registro em que os parâmetros de configuração do driver são armazenados.
NDIS_STATUS_RESOURCES	NdisOpenConfigurationEx falharam devido a recursos insuficientes.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx retornará NDIS_STATUS_FAILURE se nenhum dos valores anteriores se aplicar.

Observações

NdisOpenConfigurationEx retorna um identificador de configuração no parâmetro ConfigurationHandle. O identificador de configuração está associado a uma chave do Registro que identifica o local dos parâmetros de configuração. O chamador pode passar o identificador de configuração para outras funções de configuração do NDIS para ler ou gravar informações no Registro.

Para acessar as informações de configuração, use o identificador de configuração com as seguintes funções:

NdisReadConfiguration

NdisWriteConfiguration

NdisOpenConfigurationKeyByName NdisOpenConfigurationKeyByIndex

O tipo de dados do Registro associados ao identificador de configuração depende do tipo de identificador que o chamador passa para NdisOpenConfigurationEx no NdisHandle membro do NdisHandle NDIS_CONFIGURATION_OBJECT estrutura referenciada pelo parâmetro ConfigObject. O identificador pode identificar parâmetros associados ao driver ou a uma instância do driver.

Se o driver obteve o identificador no NdisHandle chamando o função NdisMRegisterMiniportDriver, NdisOpenConfigurationEx fornece um identificador para o local do registro em que os parâmetros de configuração do driver de miniport são armazenados. O driver de miniporto pode usar o identificador de configuração até chamar o função de NdisMDeregisterMiniportDriver.

Se o driver obteve o identificador em NdisHandle do parâmetro MiniportAdapterHandle da função MiniportInitializeEx, NdisOpenConfigurationEx fornecerá um identificador para o local do registro em que os parâmetros de configuração de um adaptador de miniporto são armazenados. Um driver de miniporto pode passar o identificador de configuração para a função NdisReadNetworkAddress para recuperar informações de endereço de rede que podem ser configuradas pelo software e administradas localmente. Os drivers de miniport podem usar o identificador de configuração até que o NDIS interrompa o adaptador de miniport e a função MiniportHaltEx retorne.

Se o driver obteve o identificador no NdisHandle chamando o função NdisRegisterProtocolDriver, NdisOpenConfigurationEx fornece um identificador para o local do registro em que os parâmetros de configuração do driver de protocolo são armazenados. O driver de protocolo pode usar o identificador de configuração até chamar o função NdisDeregisterProtocolDriver.

Se o identificador no NdisHandle for um ponteiro para uma estrutura NDIS_BIND_PARAMETERS que o NDIS passou no parâmetro BindParameters da função ProtocolBindAdapterEx, NdisOpenConfigurationEx fornecerá um identificador para o local do registro em que os parâmetros de configuração de uma associação de protocolo são armazenados. Os drivers de protocolo podem usar o identificador de configuração até que a operação de associação seja concluída.

Se o driver obteve o identificador em NdisHandle chamando a função NdisOpenAdapterEx, NdisOpenConfigurationEx fornecerá um identificador para o local do registro em que os parâmetros de configuração de uma associação de protocolo são armazenados. O driver de protocolo pode usar o identificador de configuração até chamar a função NdisCloseAdapterEx.

Se um driver de filtro obteve o identificador no NdisHandle chamando o função NdisFRegisterFilterDriver, NdisOpenConfigurationEx fornece um identificador para o local do registro em que os parâmetros de configuração do driver de filtro são armazenados. Os drivers de filtro podem usar o identificador de configuração até que chamem o função NdisFDeregisterFilterDriver.

Se um driver de filtro obteve o identificador em NdisHandle do parâmetro NdisFilterHandle da função FilterAttach, NdisOpenConfigurationEx fornecerá um identificador para o local do registro em que os parâmetros de configuração de módulos de filtro são armazenados. O driver de filtro pode usar o identificador de configuração até que o NDIS desanexe o módulo de filtro e a função FilterDetach retorne. Se um driver de filtro de monitoramento especificar o sinalizador NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION no Flags membro do NDIS_CONFIGURATION_OBJECT estrutura, o driver pode acessar a configuração do módulo de filtro para um módulo de filtro específico quando há vários módulos de filtro configurados no mesmo adaptador de miniporto. A modificação de drivers de filtro não deve usar esse sinalizador.

Depois que um driver terminar de acessar as informações de configuração, o driver deverá chamar a função NdisCloseConfiguration para liberar o identificador de configuração e os recursos relacionados.

Observação Para ter certeza de que essa função é executada em IRQL = PASSIVE_LEVEL, um driver pode agendar um item de trabalho NDIS e chamar essa e outras funções de configuração no contexto do retorno de chamada do item de trabalho.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.0 e posterior.
da 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), NdisOpenConfigurationEx(ndis)