Compartilhar via

Função NdisOpenProtocolConfiguration (ndis.h)

  • Artigo

Nota NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter o novo desenvolvimento de driver NDIS, consulte Drivers de rede começando com o Windows Vista. Para obter informações sobre como portar o NDIS 5. x drivers para NDIS 6. x, consulte Portabilidade de drivers NDIS 5.x para NDIS 6.0.

NdisOpenProtocolConfiguration retorna um identificador para a chave do Registro na qual as informações por adaptador de um driver de protocolo são armazenadas.

Sintaxe

void NdisOpenProtocolConfiguration(
  [out] PNDIS_STATUS  Status,
  [out] PNDIS_HANDLE  ConfigurationHandle,
  [in]  PCNDIS_STRING ProtocolSection
);

Parâmetros

[out] Status

Ponteiro para uma variável fornecida pelo chamador definida como NDIS_STATUS_SUCCESS ou uma falha status no retorno dessa função.

[out] ConfigurationHandle

Ponteiro para uma variável fornecida pelo chamador na qual essa função retorna o identificador para a chave do Registro para o driver de miniporto nomeado ao qual o chamador se associará mais tarde. As entradas de valor sob essa chave contêm informações específicas do adaptador instaladas pelo protocolo.

[in] ProtocolSection

Ponteiro para um tipo de NDIS_STRING fornecido pelo chamador que contém uma cadeia de caracteres contada, especificada no conjunto de caracteres padrão do sistema. Essa cadeia de caracteres contada nomeia o driver nic do NDIS, efetivamente o adaptador, para o qual a chave de parâmetros por adaptador na seção protocolo do Registro deve ser aberta. Para protocolos Windows 2000 e posteriores, essa cadeia de caracteres contada 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 .

Esse ponteiro é o parâmetro de entrada SystemSpecific1 para a função ProtocolBindAdapter do chamador.

Retornar valor

Nenhum

Comentários

NdisOpenProtocolConfiguration retorna um identificador que o chamador pode passar posteriormente para o Ndis.. Funções de configuração para recuperar ou armazenar informações no registro.

Um driver de protocolo chama NdisOpenProtocolConfiguration para obter um identificador de chave do Registro a ser passado posteriormente para outro Ndis.. Funções de configuração , como NdisRead/WriteConfiguration ou NdisOpenConfigurationKeyByName/Index, se seu arquivo de instalação armazenasse informações de configuração específicas do adaptador na seção de protocolo do registro do qual o protocolo configura suas associações.

Um protocolo pode chamar NdisOpenConfigurationKeyByName ou NdisOpenConfigurationKeyByIndex para abrir qualquer subchave da chave do Registro para a qual NdisOpenProtocolConfiguration retorna o identificador .

Os protocolos Windows 2000 e posteriores chamam rotinas de suporte do modo kernel para abrir suas próprias chaves de registro específicas do protocolo. Para obter mais informações sobre essas rotinas de suporte, consulte o Resumo de rotinas de suporte Kernel-Mode e rotinas de suporte de gerenciamento de energia.

  • Plataforma de destino: Universal
  • Versão: não há suporte para drivers NDIS 6.0 no Windows Vista. Em vez disso, use NdisOpenConfigurationEx. Com suporte para drivers NDIS 5.1 no Windows Vista e windows XP.

Requisitos

Requisito Valor
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL

Confira também