NdisOpenConfiguration

9/8/2008

Essa função retorna um identificador para do um driver NDIS NIC \DriverName\Parms chave Registro.

Syntax

VOID NdisOpenConfiguration(
  PNDIS_STATUS Status,
  PNDIS_HANDLE ConfigurationHandle,
  NDIS_HANDLE WrapperConfigurationContext
);

Parameters

• Status
  [out] Ponteiro para uma variável Caller-supplied no qual essa função retorna o status de sua tentativa aberto a chave Registro

• ConfigurationHandle
  [out] Ponteiro para uma variável Caller-supplied no qual essa função retorna um identificador para o Registro HKEY_LOCAL_MACHINE\Comm\DriverName\Parms chave. Entradas de valor sob essa chave são fornecidas pelo script instalação do driver.

• WrapperConfigurationContext
  [no] Manipular entrada para o MiniportInitialize função.

Return Value

A seguinte tabela mostra os possíveis valores de retorno.

Valor	Descrição
NDIS_STATUS_SUCCESS	O valor no ConfigurationHandle é válido.
NDIS_STATUS_FAILURE	Não foi possível abrir a chave.
Manipular	Especifica um identificador para o Registro HKEY_LOCAL_MACHINE\Comm\DriverName\Parms chave.

Remarks

Com o identificador retornado por essa função, uma miniporta NDIS pode chamar o NdisReadConfiguration função uma ou mais vezes para extrair informações configuração sobre seu NIC a partir de Registro. Uma miniporta também pode chamar NdisReadNetworkAddress Com esse identificador ao software recuperar-configurável informações endereço rede que foi armazenadas no Registro quando seu NIC foi instalado na atual computador.

Script instalação de uma miniporta deve armazenar no mínimo o seguinte configuração informações no Registro:

• E/S barramento interface tipo do NIC.
• Se não estiver em um barramento ISA, número de barramento.
• Valor identificador adaptador de NIC, que, depending on o E/S barramento interface tipo, é equivalente para o seguinte barramento - tipo - configuração específica valor de dados:
  Se o NIC estiver em um barramento PCI, o valor do PCI DeviceId

Drivers de placas de rede em ISA barramentos geralmente barramento get-relativo parâmetros configuração para um NIC a partir de Registro com o NdisReadConfiguration função. Drivers de placas de rede em outros tipos de barramentos E/S também pode chamar NDISXXX barramento - tipo - funções configuração específica para barramento get-relativo parâmetros configuração NIC-específico adequados para chamado funções, como NdisMRegisterInterrupt, NdisMMapIoSpace, e / ou NdisMRegisterIoPortRange.

Um driver NIC chama o NdisMSetAttributes ou o NdisMSetAttributesEx função para identificar o tipo de barramento E/S no qual seu NIC é provável que encontrado antes desse driver chama qualquer uma das funções de configuração específicas barramento - tipo -.

Após um driver tiver consumidos e, possivelmente, modificadas informações de configuração Registro, o driver deve chamar o NdisCloseConfiguration função para o identificador obtido desta função e a versão livre qualquer armazenamento temporário que NDIS alocados em chamadas do driver para NdisReadConfiguration, NdisReadNetworkAddress, e / ou NdisWriteConfiguration.

Requirements

Header	ndis.h
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

MiniportInitialize
NdisCloseConfiguration
NdisMMapIoSpace
NdisMRegisterInterrupt
NdisMRegisterIoPortRange
NdisMRegisterMiniport
NdisMSetAttributes
NdisMSetAttributesEx
NdisOpenProtocolConfiguration
NdisReadConfiguration
NdisReadNetworkAddress
NdisReadPciSlotInformation
NdisRegisterProtocol
NdisWriteConfiguration