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