NdisReadConfiguration

9/8/2008

Essa função retorna o valor de um nomeado entrada do tipo especificado a partir de Registro, como longo que ele tenha o identificador para um aberto chave Registro.

Syntax

VOID NdisReadConfiguration(
  PNDIS_STATUS Status,
  PNDIS_CONFIGURATION_PARAMETER* ParameterValue,
  NDIS_HANDLE ConfigurationHandle,
  PNDIS_STRING Keyword,
  NDIS_PARAMETER_TYPE ParameterType
);

Parameters

• Status
  [out] Ponteiro para uma variável Caller-supplied no qual essa função retorna o status do chamar.

• ParameterValue
  [out] Ponteiro para uma variável Caller-supplied no qual um bem-sucedido chamar para essa função retorna um ponteiro para um NDIS_CONFIGURATION_PARAMETER estrutura.

• ConfigurationHandle
  [no] Identificador retornado por NdisOpenConfiguration Para do um driver NIC XXX\DriverName\Parms chave Registro ou por NdisOpenProtocolConfiguration Para do um protocolo XXX\NICDriverInstance\Parms\ProtocolName chave na seção protocolo do Registro.

• Palavra-chave
  [no] Ponteiro para um chamador-fornecido contados seqüência de caracteres, no sistema-conjunto de caracteres usar como padrão, especificando o nome da entrada sob o aberto chave do Registro para o qual retornar o valor. Este parâmetro também pode apontar para um do seguinte predefinidos palavras-chave global para todos os drivers NDIS:

  • Ambiente
  • Tipo de processador

• ParameterType
  [no] Especifica o tipo de entrada de valor como um do seguinte.

  Valor	Descrição
  NdisParameterInteger	Especifica um inteiro, decimal em notação.
  NdisParameterHexInteger	Especifica um inteiro em hexadecimal notação.
  NdisParameterString	Especifica um seqüência de caracteres de tipo NDIS_STRING.
  NdisParameterMultiString	Especifica um parâmetro do tipo de REG_MULTI_SZ Microsoft_®_Windows_NT_®-defined multistring.

Return Value

A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
NDIS_STATUS_SUCCESS	A reserva especificada no ParameterValue Contém informações de configuração retornado.
NDIS_STATUS_RESOURCES	NDIS não pôde alocar recursos, geralmente suficiente memória, para retornar as informações solicitadas.
NDIS_STATUS_FAILURE	As informações solicitadas não pôde ser encontradas sob a chave do Registro aberto designado pela ConfigurationHandle.

Remarks

Cada driver NDIS pode configurar configuração informações no Registro para si mesmo sob do o driver Parâmetros chave, usando um script instalação. De exemplo, um driver protocolo pode armazenar seu próprio nome como uma entrada com um valor da seqüência de caracteres pré-formatadas que podem ser passadas em chamadas para o NdisRegisterProtocol função.

Cada driver NIC também tem associado entradas valor sob do o driver Parâmetros chave Registro. As entradas valor para qualquer driver NIC específico podem ser dispositivo-dependente por natureza. De exemplo, um driver Ethernet NIC pode ter palavras-chave como InterruptNumber, SharedMemoryAddress, e MulticastListSize. O valor associado com tal um NDIS palavra-chave pode ser qualquer uma (inteiroULONG-tipo) ou um seqüência de caracteres (NDIS_STRING-tipo). De exemplo, o conjunto de valores possíveis para o InterruptNumber entrada mencionada talvez NdisParameterInteger Valores 2, 3, 4, ou 5 ou os equivalentes em hexadecimal como NdisParameterHexInteger Os valores.

Essa função buffers e copia o seqüência de caracteres Caller-supplied no Palavra-chave e libera o armazenamento que ele aloca para este copiar antes ela retorna controle para o chamador. A memória que ele aloca para o NDIS_CONFIGURATION_PARAMETER estrutura é liberada quando o driver libera o ConfigurationHandle Com o NdisCloseConfigurationfunção. O chamador desta função é responsável por liberando a armazenada em buffer seqüência de caracteres no Palavra-chave.

Requirements

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

See Also

Reference

NdisAnsiStringToUnicodeString
NdisCloseConfiguration
NdisFreeString
NdisInitAnsiString
NdisInitializeString
NdisInitUnicodeString
NdisOpenConfiguration
NdisOpenProtocolConfiguration
NdisReadNetworkAddress
NdisUnicodeStringToAnsiString
NdisWriteConfiguration
NDIS_CONFIGURATION_PARAMETER
NdisRegisterProtocol