Função NdisOpenConfigurationEx (ndis.h)

Artigo
08/07/2023

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.

Retornar valor

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	Falha em NdisOpenConfigurationEx devido a recursos insuficientes.
NDIS_STATUS_FAILURE	NdisOpenConfigurationEx retornará NDIS_STATUS_FAILURE se nenhum dos valores anteriores se aplicar.

Comentários

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 membro NdisHandle do 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 miniporte pode usar o identificador de configuração até chamar o Função NdisMDeregisterMiniportDriver .

Se o driver obteve o identificador em NdisHandle do parâmetro MiniportAdapterHandle da função MiniportInitializeEx , NdisOpenConfigurationEx fornece um identificador para o local do registro em que os parâmetros de configuração de um adaptador de miniport são armazenados. Um driver de miniporte 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 em 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 no NdisHandle chamando a função NdisOpenAdapterEx , NdisOpenConfigurationEx fornece 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 fornece 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 membro Flags 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 houver vários módulos de filtro configurados no mesmo adaptador de miniporte. 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.

Nota 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
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
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)