Função NdisOpenProtocolConfiguration (ndis.h)

Observação NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter um 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 o 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 que está definida como NDIS_STATUS_SUCCESS ou um status de falha ao retornar 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 e 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 de protocolo do Registro deve ser aberta. Para o Windows 2000 e protocolos posteriores, essa cadeia de caracteres contada contém caracteres Unicode. Ou seja, para o Windows 2000 e posterior, o NDIS define o tipo de NDIS_STRING como um tipo de UNICODE_STRING.

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

Valor de retorno

Nenhum

Observações

NdisOpenProtocolConfiguration retorna um identificador que o chamador pode passar posteriormente para o Ndis.. A configuração funções 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 outras Ndis.. Funções de 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. Use NdisOpenConfigurationEx. Com suporte para drivers NDIS 5.1 no Windows Vista e no Windows XP.

Requisitos

Consulte também

• ANSI_STRING
• NdisCloseConfiguration
• NdisInitializeString
• NdisInitUnicodeString
• NdisOpenConfigurationKeyByIndex
• NdisOpenConfigurationKeyByName
• NdisReadConfiguration
• NdisWriteConfiguration
• ProtocolBindAdapter
• UNICODE_STRING